/*-------------------------------------------------------------------- * The MB-system: mbsys_gsf.h 6/10/97 * $Id: mbsys_gsf.h 1985 2012-09-11 08:02:53Z caress $ * * Copyright (c) 1998-2012 by * David W. Caress (caress@mbari.org) * Monterey Bay Aquarium Research Institute * Moss Landing, CA 95039 * and Dale N. Chayes (dale@ldeo.columbia.edu) * Lamont-Doherty Earth Observatory * Palisades, NY 10964 * * See README file for copying and redistribution conditions. *--------------------------------------------------------------------*/ /* * mbsys_gsf.h defines the data structures used by MBIO functions * to store data from the Generic Sensor Format (GSF). * The MBIO representation of GSF is: * MBF_GSFGENMB : MBIO ID 121 * * * Author: D. W. Caress * Date: March 5, 1998 * * $Log: mbsys_gsf.h,v $ * Revision 5.7 2009/03/13 07:05:58 caress * Release 5.1.2beta02 * * Revision 5.6 2006/03/06 21:47:48 caress * Implemented changes suggested by Bob Courtney of the Geological Survey of Canada to support translating Reson data to GSF. * * Revision 5.5 2005/11/05 00:48:05 caress * Programs changed to register arrays through mb_register_array() rather than allocating the memory directly with mb_realloc() or mb_malloc(). * * Revision 5.4 2003/04/17 21:05:23 caress * Release 5.0.beta30 * * Revision 5.3 2002/09/18 23:32:59 caress * Release 5.0.beta23 * * Revision 5.2 2001/07/20 00:32:54 caress * Release 5.0.beta03 * * Revision 5.1 2001/01/22 07:43:34 caress * Version 5.0.beta01 * * Revision 5.0 2000/12/01 22:48:41 caress * First cut at Version 5.0. * * Revision 4.1 2000/09/30 06:31:19 caress * Snapshot for Dale. * * Revision 4.0 1998/10/05 19:16:02 caress * MB-System version 4.6beta * * Revision 1.1 1998/10/05 18:32:27 caress * Initial revision * * Revision 1.1 1998/10/05 18:22:40 caress * Initial revision * * Revision 1.1 1998/10/05 17:46:15 caress * Initial revision * * */ /* * Notes on the MBF_GSFGENMB data format: * 1. The underlying data format is the Generic Sensor Format (GSF) * developed by Shannon Byrne of SAIC. The GSF format stores swath * bathymetry, single beam bathymetry, and other data. * 2. This MBIO i/o module accesses swath bathymtry data stored in * the GSF format using the gsflib library also written at SAIC. * The gsflib calls translate the data from scaled short integers * (big endian) stored in the file to double values. The sensor * specific values held in the GSF data stream are not * accessed by this module. However, all of the GSF records * and the included information are passed when mb_get_all, * mb_put_all, and the mb_buffer routines are used for * reading and writing. * */ #ifndef __GSF_H__ #include "gsf.h" #endif #ifndef _GSF_FT_H_ #include "gsf_ft.h" #endif #ifndef _GSF_ENC_H_ #include "gsf_enc.h" #endif /* internal data structure */ struct mbsys_gsf_struct { int kind; gsfDataID dataID; gsfRecords records; }; /* system specific function prototypes */ int mbsys_gsf_alloc(int verbose, void *mbio_ptr, void **store_ptr, int *error); int mbsys_gsf_deall(int verbose, void *mbio_ptr, void **store_ptr, int *error); int mbsys_gsf_dimensions(int verbose, void *mbio_ptr, void *store_ptr, int *kind, int *nbath, int *namp, int *nss, int *error); int mbsys_gsf_sonartype(int verbose, void *mbio_ptr, void *store_ptr, int *sonartype, int *error); int mbsys_gsf_sidescantype(int verbose, void *mbio_ptr, void *store_ptr, int *ss_type, int *error); int mbsys_gsf_extract(int verbose, void *mbio_ptr, void *store_ptr, int *kind, int time_i[7], double *time_d, double *navlon, double *navlat, double *speed, double *heading, int *nbath, int *namp, int *nss, char *beamflag, double *bath, double *amp, double *bathacrosstrack, double *bathalongtrack, double *ss, double *ssacrosstrack, double *ssalongtrack, char *comment, int *error); int mbsys_gsf_insert(int verbose, void *mbio_ptr, void *store_ptr, int kind, int time_i[7], double time_d, double navlon, double navlat, double speed, double heading, int nbath, int namp, int nss, char *beamflag, double *bath, double *amp, double *bathacrosstrack, double *bathalongtrack, double *ss, double *ssacrosstrack, double *ssalongtrack, char *comment, int *error); int mbsys_gsf_ttimes(int verbose, void *mbio_ptr, void *store_ptr, int *kind, int *nbeams, double *ttimes, double *angles, double *angles_forward, double *angles_null, double *heave, double *alongtrack_offset, double *draft, double *ssv, int *error); int mbsys_gsf_detects(int verbose, void *mbio_ptr, void *store_ptr, int *kind, int *nbeams, int *detects, int *error); int mbsys_gsf_extract_altitude(int verbose, void *mbio_ptr, void *store_ptr, int *kind, double *transducer_depth, double *altitude, int *error); int mbsys_gsf_insert_altitude(int verbose, void *mbio_ptr, void *store_ptr, double transducer_depth, double altitude, int *error); int mbsys_gsf_extract_nav(int verbose, void *mbio_ptr, void *store_ptr, int *kind, int time_i[7], double *time_d, double *navlon, double *navlat, double *speed, double *heading, double *draft, double *roll, double *pitch, double *heave, int *error); int mbsys_gsf_insert_nav(int verbose, void *mbio_ptr, void *store_ptr, int time_i[7], double time_d, double navlon, double navlat, double speed, double heading, double draft, double roll, double pitch, double heave, int *error); int mbsys_gsf_extract_svp(int verbose, void *mbio_ptr, void *store_ptr, int *kind, int *nsvp, double *depth, double *velocity, int *error); int mbsys_gsf_insert_svp(int verbose, void *mbio_ptr, void *store_ptr, int nsvp, double *depth, double *velocity, int *error); int mbsys_gsf_copy(int verbose, void *mbio_ptr, void *store_ptr, void *copy_ptr, int *error); int mbsys_gsf_getscale(int verbose, double *data, char *flag, int ndata, int nbits, int signedvalue, double *multiplier, double *offset, int *error);