mgd77header(1) GMT mgd77header(1)
NAME
mgd77header - Create MGD77 headers from A77 files
SYNOPSIS
mgd77header NGDC-id.a77 [ -Hheadervalues.txt ] [ -Mf[item]|r|t ] [
-V[level] ]
Note: No space is allowed between the option flag and the associated
arguments.
DESCRIPTION
mgd77header generates an MGD77 header by reading A77 data (i.e., the
data record portion of MGD77 files), determines temporal and spatial
extents, ten degree boxes crossed, and data columns present. Option-
ally, it can also read an input file consisting of header field values
(-H) to be included in program output. Header field values determined
from data and read from input are output in either MGD77 format or as a
list.
REQUIRED ARGUMENTS
NGDC-ids
Can be one or more of five kinds of specifiers:
1. 8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.
2. 2-character agency codes which will return all cruises from
each agency.
3. 4-character <agency><vessel> codes, which will return all
cruises from those vessels.
4. =list, where list is a table with NGDC IDs, one per line.
5. If nothing is specified we return all cruises in the data
base.
(See mgd77info -L for agency and vessel codes). If no file
extension is given then we search for files with one of the four
known extensions. The search order (and the extensions) tried
is MGD77+ (a.nca), MGD77T (a.m77ta), MGD77 (a.mgd77a ) and plain
text file (a.data). Use -I to ignore one or more of these file
types). Cruise files will be looked for first in the current
directory and second in all directories listed in
$MGD77_HOME/mgd77_paths.txt [If $MGD77_HOME is not set it will
default to $GMT_SHAREDIR/mgd77].
OPTIONAL ARGUMENTS
-Hheadervalues.txt
Obtain header field values from the input text file. Each row of
the input file should consist of a header field name and its
desired value, separated by a space. See below for a sample
header file and for the full list of header field names.
-Mf[item]|r|r
List the meta-data (header) for each cruise. Append f for a for-
matted display. This will list individual parameters and their
values, one entry per output line, in a format that can be
searched using standard UNIX text tools. Alternatively, append
the name of a particular parameter (you only need to give enough
characters - starting at the beginning - to uniquely identify
the item). Give - to display the list of all parameter names.
You may also specify the number of a parameter. For the raw,
punchcard-formatted MGD77 original header block, append r
instead. For the M77T format, append t instead.
-V[level] (more a|)
Select verbosity level [c].
-^ or just -
Print a short message about the syntax of the command, then
exits (NOTE: on Windows just use -).
-+ or just +
Print an extensive usage (help) message, including the explana-
tion of any module-specific option (but not the GMT common
options), then exits.
-? or no arguments
Print a complete usage (help) message, including the explanation
of all options, then exits.
HEADER ITEM SAMPLE FILE
Format_Acronym MGD77
Source_Institution SOEST - UNIV. OF HAWAII
Country USA
Platform_Name KILO MOANA
Platform_Type_Code 1
Platform_Type SHIP
NAMES OF ALL MGD77 HEADER FIELDS
Survey_Identifier
Format_Acronym
Data_Center_File_Number
Parameters_Surveyed_Code
File_Creation_Year
File_Creation_Month
File_Creation_Day
Source_Institution
Country
Platform_Name
Platform_Type_Code
Platform_Type
Chief_Scientist
Project_Cruise_Leg
Funding
Survey_Departure_Year
Survey_Departure_Month
Survey_Departure_Day
Port_of_Departure
Survey_Arrival_Year
Survey_Arrival_Month
Survey_Arrival_Day
Port_of_Arrival
Navigation_Instrumentation
Geodetic_Datum_Position_Determination_Method
Bathymetry_Instrumentation
Bathymetry_Add_Forms_of_Data
Magnetics_Instrumentation
Magnetics_Add_Forms_of_Data
Gravity_Instrumentation
Gravity_Add_Forms_of_Data
Seismic_Instrumentation
Seismic_Data_Formats
Format_Type
Format_Description
Topmost_Latitude
Bottommost_Latitude
Leftmost_Longitude
Rightmost_Longitude
Bathymetry_Digitizing_Rate
Bathymetry_Sampling_Rate
Bathymetry_Assumed_Sound_Velocity
Bathymetry_Datum_Code
Bathymetry_Interpolation_Scheme
Magnetics_Digitizing_Rate
Magnetics_Sampling_Rate
Magnetics_Sensor_Tow_Distance
Magnetics_Sensor_Depth
Magnetics_Sensor_Separation
Magnetics_Ref_Field_Code
Magnetics_Ref_Field
Magnetics_Method_Applying_Res_Field
Gravity_Digitizing_Rate
Gravity_Sampling_Rate
Gravity_Theoretical_Formula_Code
Gravity_Theoretical_Formula
Gravity_Reference_System_Code
Gravity_Reference_System
Gravity_Corrections_Applied
Gravity_Departure_Base_Station
Gravity_Departure_Base_Station_Name
Gravity_Arrival_Base_Station
Gravity_Arrival_Base_Station_Name
Number_of_Ten_Degree_Identifiers
Ten_Degree_Identifier
Additional_Documentation_1
Additional_Documentation_2
Additional_Documentation_3
Additional_Documentation_4
Additional_Documentation_5
Additional_Documentation_6
Additional_Documentation_7
EXAMPLES
To generate an MGD77 header from A77 input, try
gmt mgd77header km0201 -Hkmheaderitems.txt -Mf > km0201.h77
SEE ALSO
mgd77info(1), mgd77list(1), mgd77manage(1), mgd77path(1),
mgd77track(1), x2sys_init(1)
REFERENCES
The Marine Geophysical Data Exchange Format - MGD77, see
http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt.
COPYRIGHT
2017, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
5.4.2 Jun 24, 2017 mgd77header(1)
gmt5 5.4.2 - Generated Thu Jun 29 14:28:34 CDT 2017