.\" Man page generated from reStructuredText.
.
.TH "MGD77HEADER" "1gmt" "May 21, 2019" "5.4.5" "GMT"
.SH NAME
mgd77header \- Create MGD77 headers from A77 files
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBmgd77header\fP \fINGDC\-id.a77\fP
[  \fB\-H\fP\fIheadervalues.txt\fP ]
[  \fB\-M\fP\fBf\fP[\fIitem\fP]|\fBr\fP|\fBt\fP ]
[  \fB\-V\fP[\fIlevel\fP] ]
.sp
\fBNote:\fP No space is allowed between the option flag and the associated arguments.
.SH DESCRIPTION
.sp
\fBmgd77header\fP 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. Optionally,
it can also read an input file consisting of header field values (\fB\-H\fP)
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.
.SH REQUIRED ARGUMENTS
.INDENT 0.0
.TP
.B \fINGDC\-ids\fP
Can be one or more of five kinds of specifiers:
.INDENT 7.0
.IP 1. 3
8\-character NGDC IDs, e.g., 01010083, JA010010etc., etc.
.IP 2. 3
2\-character \fIagency\fP codes which will return all cruises from each agency.
.IP 3. 3
4\-character <agency><vessel> codes, which will return all cruises from those vessels.
.IP 4. 3
=\fIlist\fP, where \fIlist\fP is a table with NGDC IDs, one per line.
.IP 5. 3
If nothing is specified we return all cruises in the data base.
.UNINDENT
.sp
(See mgd77info \fB\-L\fP 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+ (".nc"), MGD77T (".m77t"), MGD77 (".mgd77" ) and plain
text file (".dat").  Use \fB\-I\fP 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 \fB$MGD77_HOME\fP/mgd77_paths.txt [If \fB$MGD77_HOME\fP is
not set it will default to \fB$GMT_SHAREDIR\fP/mgd77].
.UNINDENT
.SH OPTIONAL ARGUMENTS
.INDENT 0.0
.TP
\fB\-H\fP\fIheadervalues.txt\fP
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.
.UNINDENT
.INDENT 0.0
.TP
\fB\-Mf\fP[\fIitem\fP]|\fBr\fP|\fBr\fP
List the meta\-data (header) for
each cruise. Append \fBf\fP for a formatted 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
\fBr\fP instead. For the M77T format, append \fBt\fP instead.
.UNINDENT
.INDENT 0.0
.TP
\fB\-V\fP[\fIlevel\fP] (more ...)
Select verbosity level [c].  
.UNINDENT
.INDENT 0.0
.TP
\fB\-^\fP or just \fB\-\fP
Print a short message about the syntax of the command, then exits (NOTE: on Windows just use \fB\-\fP).
.TP
\fB\-+\fP or just \fB+\fP
Print an extensive usage (help) message, including the explanation of
any module\-specific option (but not the GMT common options), then exits.
.TP
\fB\-?\fP or no arguments
Print a complete usage (help) message, including the explanation of all options, then exits.
.UNINDENT
.SH HEADER ITEM SAMPLE FILE
.sp
Format_Acronym MGD77
.sp
Source_Institution SOEST \- UNIV. OF HAWAII
.sp
Country USA
.sp
Platform_Name KILO MOANA
.sp
Platform_Type_Code 1
.sp
Platform_Type SHIP
.SH NAMES OF ALL MGD77 HEADER FIELDS
.sp
Survey_Identifier
.sp
Format_Acronym
.sp
Data_Center_File_Number
.sp
Parameters_Surveyed_Code
.sp
File_Creation_Year
.sp
File_Creation_Month
.sp
File_Creation_Day
.sp
Source_Institution
.sp
Country
.sp
Platform_Name
.sp
Platform_Type_Code
.sp
Platform_Type
.sp
Chief_Scientist
.sp
Project_Cruise_Leg
.sp
Funding
.sp
Survey_Departure_Year
.sp
Survey_Departure_Month
.sp
Survey_Departure_Day
.sp
Port_of_Departure
.sp
Survey_Arrival_Year
.sp
Survey_Arrival_Month
.sp
Survey_Arrival_Day
.sp
Port_of_Arrival
.sp
Navigation_Instrumentation
.sp
Geodetic_Datum_Position_Determination_Method
.sp
Bathymetry_Instrumentation
.sp
Bathymetry_Add_Forms_of_Data
.sp
Magnetics_Instrumentation
.sp
Magnetics_Add_Forms_of_Data
.sp
Gravity_Instrumentation
.sp
Gravity_Add_Forms_of_Data
.sp
Seismic_Instrumentation
.sp
Seismic_Data_Formats
.sp
Format_Type
.sp
Format_Description
.sp
Topmost_Latitude
.sp
Bottommost_Latitude
.sp
Leftmost_Longitude
.sp
Rightmost_Longitude
.sp
Bathymetry_Digitizing_Rate
.sp
Bathymetry_Sampling_Rate
.sp
Bathymetry_Assumed_Sound_Velocity
.sp
Bathymetry_Datum_Code
.sp
Bathymetry_Interpolation_Scheme
.sp
Magnetics_Digitizing_Rate
.sp
Magnetics_Sampling_Rate
.sp
Magnetics_Sensor_Tow_Distance
.sp
Magnetics_Sensor_Depth
.sp
Magnetics_Sensor_Separation
.sp
Magnetics_Ref_Field_Code
.sp
Magnetics_Ref_Field
.sp
Magnetics_Method_Applying_Res_Field
.sp
Gravity_Digitizing_Rate
.sp
Gravity_Sampling_Rate
.sp
Gravity_Theoretical_Formula_Code
.sp
Gravity_Theoretical_Formula
.sp
Gravity_Reference_System_Code
.sp
Gravity_Reference_System
.sp
Gravity_Corrections_Applied
.sp
Gravity_Departure_Base_Station
.sp
Gravity_Departure_Base_Station_Name
.sp
Gravity_Arrival_Base_Station
.sp
Gravity_Arrival_Base_Station_Name
.sp
Number_of_Ten_Degree_Identifiers
.sp
Ten_Degree_Identifier
.sp
Additional_Documentation_1
.sp
Additional_Documentation_2
.sp
Additional_Documentation_3
.sp
Additional_Documentation_4
.sp
Additional_Documentation_5
.sp
Additional_Documentation_6
.sp
Additional_Documentation_7
.SH EXAMPLES
.sp
To generate an MGD77 header from A77 input, try
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gmt mgd77header km0201 \-Hkmheaderitems.txt \-Mf > km0201.h77
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
mgd77info,
mgd77list,
mgd77manage,
mgd77path,
mgd77track,
x2sys_init
.SH REFERENCES
.sp
The Marine Geophysical Data Exchange Format \- MGD77, see
\fI\%http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt.\fP
.SH COPYRIGHT
2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
.\" Generated by docutils manpage writer.
.