1MGD77HEADER(1) GMT MGD77HEADER(1)
2
6 mgd77header - Create MGD77 headers from A77 files
7
9 mgd77header NGDC-id.a77 [ -Hheadervalues.txt ] [ -Mf[item]|r|t ] [
10 -V[level] ]
11 Note: No space is allowed between the option flag and the associated
13 arguments.
14
16 mgd77header generates an MGD77 header by reading A77 data (i.e., the
17 data record portion of MGD77 files), determines temporal and spatial
18 extents, ten degree boxes crossed, and data columns present. Option‐
19 ally, it can also read an input file consisting of header field values
20 (-H) to be included in program output. Header field values determined
21 from data and read from input are output in either MGD77 format or as a
22 list.
23
25 NGDC-ids
26 Can be one or more of five kinds of specifiers:
27 1. 8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.
29 2. 2-character agency codes which will return all cruises from
31 each agency.
32 3. 4-character <agency><vessel> codes, which will return all
34 cruises from those vessels.
35 4. =list, where list is a table with NGDC IDs, one per line.
37 5. If nothing is specified we return all cruises in the data
39 base.
40 (See mgd77info -L for agency and vessel codes). If no file
42 extension is given then we search for files with one of the four
43 known extensions. The search order (and the extensions) tried
44 is MGD77+ (".nc"), MGD77T (".m77t"), MGD77 (".mgd77" ) and plain
45 text file (".dat"). Use -I to ignore one or more of these file
46 types). Cruise files will be looked for first in the current
47 directory and second in all directories listed in
48 $MGD77_HOME/mgd77_paths.txt [If $MGD77_HOME is not set it will
49 default to $GMT_SHAREDIR/mgd77].
50
52 -Hheadervalues.txt
53 Obtain header field values from the input text file. Each row of
54 the input file should consist of a header field name and its
55 desired value, separated by a space. See below for a sample
56 header file and for the full list of header field names.
57 -Mf[item]|r|r
59 List the meta-data (header) for each cruise. Append f for a for‐
60 matted display. This will list individual parameters and their
61 values, one entry per output line, in a format that can be
62 searched using standard UNIX text tools. Alternatively, append
63 the name of a particular parameter (you only need to give enough
64 characters - starting at the beginning - to uniquely identify
65 the item). Give - to display the list of all parameter names.
66 You may also specify the number of a parameter. For the raw,
67 punchcard-formatted MGD77 original header block, append r
68 instead. For the M77T format, append t instead.
69 -V[level] (more ...)
71 Select verbosity level [c].
72 -^ or just -
74 Print a short message about the syntax of the command, then
75 exits (NOTE: on Windows just use -).
76 -+ or just +
78 Print an extensive usage (help) message, including the explana‐
79 tion of any module-specific option (but not the GMT common
80 options), then exits.
81 -? or no arguments
83 Print a complete usage (help) message, including the explanation
84 of all options, then exits.
85
87 Format_Acronym MGD77
88 Source_Institution SOEST - UNIV. OF HAWAII
90 Country USA
92 Platform_Name KILO MOANA
94 Platform_Type_Code 1
96 Platform_Type SHIP
98
100 Survey_Identifier
101 Format_Acronym
103 Data_Center_File_Number
105 Parameters_Surveyed_Code
107 File_Creation_Year
109 File_Creation_Month
111 File_Creation_Day
113 Source_Institution
115 Country
117 Platform_Name
119 Platform_Type_Code
121 Platform_Type
123 Chief_Scientist
125 Project_Cruise_Leg
127 Funding
129 Survey_Departure_Year
131 Survey_Departure_Month
133 Survey_Departure_Day
135 Port_of_Departure
137 Survey_Arrival_Year
139 Survey_Arrival_Month
141 Survey_Arrival_Day
143 Port_of_Arrival
145 Navigation_Instrumentation
147 Geodetic_Datum_Position_Determination_Method
149 Bathymetry_Instrumentation
151 Bathymetry_Add_Forms_of_Data
153 Magnetics_Instrumentation
155 Magnetics_Add_Forms_of_Data
157 Gravity_Instrumentation
159 Gravity_Add_Forms_of_Data
161 Seismic_Instrumentation
163 Seismic_Data_Formats
165 Format_Type
167 Format_Description
169 Topmost_Latitude
171 Bottommost_Latitude
173 Leftmost_Longitude
175 Rightmost_Longitude
177 Bathymetry_Digitizing_Rate
179 Bathymetry_Sampling_Rate
181 Bathymetry_Assumed_Sound_Velocity
183 Bathymetry_Datum_Code
185 Bathymetry_Interpolation_Scheme
187 Magnetics_Digitizing_Rate
189 Magnetics_Sampling_Rate
191 Magnetics_Sensor_Tow_Distance
193 Magnetics_Sensor_Depth
195 Magnetics_Sensor_Separation
197 Magnetics_Ref_Field_Code
199 Magnetics_Ref_Field
201 Magnetics_Method_Applying_Res_Field
203 Gravity_Digitizing_Rate
205 Gravity_Sampling_Rate
207 Gravity_Theoretical_Formula_Code
209 Gravity_Theoretical_Formula
211 Gravity_Reference_System_Code
213 Gravity_Reference_System
215 Gravity_Corrections_Applied
217 Gravity_Departure_Base_Station
219 Gravity_Departure_Base_Station_Name
221 Gravity_Arrival_Base_Station
223 Gravity_Arrival_Base_Station_Name
225 Number_of_Ten_Degree_Identifiers
227 Ten_Degree_Identifier
229 Additional_Documentation_1
231 Additional_Documentation_2
233 Additional_Documentation_3
235 Additional_Documentation_4
237 Additional_Documentation_5
239 Additional_Documentation_6
241 Additional_Documentation_7
243
245 To generate an MGD77 header from A77 input, try
246 gmt mgd77header km0201 -Hkmheaderitems.txt -Mf > km0201.h77
248
250 mgd77info, mgd77list, mgd77manage, mgd77path, mgd77track, x2sys_init
251
253 The Marine Geophysical Data Exchange Format - MGD77, see
254 http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt.
255
257 2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
2585.4.5 Feb 24, 2019 MGD77HEADER(1)