.TH MGD77HEADER 1gmt "Feb 27 2014" "GMT 4.5.13 (SVN)" "Generic Mapping Tools"
.SH NAME
mgd77header \- Generate MGD77 header from data records
.SH SYNOPSIS
\fBmgd77header\fP \fINGDC-id.a77\fP [ \fB\-H\fP\fBheadervalues.txt\fP ] [ \fB\-M\fP\fBf\fP|\fBr\fP ] [ \fB\-V\fP ]
.SH DESCRIPTION
\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 (f) or as a list (r) (\fB\-M\fP).
.SH OPTIONS
No space between the option flag and the associated arguments.
.TP
\fB\-H\fP
Obtain header field values from an 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.
.TP
\fB\-M\fP
Choose between MGD77 formatted header output \fBf\fP or list \fBr\fP.
.TP
\fB\-V\fP
Selects verbose mode, which will send progress reports to stderr [Default runs "silently"].
.SH Header Item Sample File:
.br
Format_Acronym MGD77
.br
Source_Institution SOEST - UNIV. OF HAWAII
.br
Country USA
.br
Platform_Name KILO MOANA
.br
Platform_Type_Code 1
.br
Platform_Type SHIP
.SH Names of All MGD77 Header Fields
.br
Survey_Identifier
.br
Format_Acronym
.br
Data_Center_File_Number
.br
Parameters_Surveyed_Code
.br
File_Creation_Year
.br
File_Creation_Month
.br
File_Creation_Day
.br
Source_Institution
.br
Country
.br
Platform_Name
.br
Platform_Type_Code
.br
Platform_Type
.br
Chief_Scientist
.br
Project_Cruise_Leg
.br
Funding
.br
Survey_Departure_Year
.br
Survey_Departure_Month
.br
Survey_Departure_Day
.br
Port_of_Departure
.br
Survey_Arrival_Year
.br
Survey_Arrival_Month
.br
Survey_Arrival_Day
.br
Port_of_Arrival
.br
Navigation_Instrumentation
.br
Geodetic_Datum_Position_Determination_Method
.br
Bathymetry_Instrumentation
.br
Bathymetry_Add_Forms_of_Data
.br
Magnetics_Instrumentation
.br
Magnetics_Add_Forms_of_Data
.br
Gravity_Instrumentation
.br
Gravity_Add_Forms_of_Data
.br
Seismic_Instrumentation
.br
Seismic_Data_Formats
.br
Format_Type
.br
Format_Description
.br
Topmost_Latitude
.br
Bottommost_Latitude
.br
Leftmost_Longitude
.br
Rightmost_Longitude
.br
Bathymetry_Digitizing_Rate
.br
Bathymetry_Sampling_Rate
.br
Bathymetry_Assumed_Sound_Velocity
.br
Bathymetry_Datum_Code
.br
Bathymetry_Interpolation_Scheme
.br
Magnetics_Digitizing_Rate
.br
Magnetics_Sampling_Rate
.br
Magnetics_Sensor_Tow_Distance
.br
Magnetics_Sensor_Depth
.br
Magnetics_Sensor_Separation
.br
Magnetics_Ref_Field_Code
.br
Magnetics_Ref_Field
.br
Magnetics_Method_Applying_Res_Field
.br
Gravity_Digitizing_Rate
.br
Gravity_Sampling_Rate
.br
Gravity_Theoretical_Formula_Code
.br
Gravity_Theoretical_Formula
.br
Gravity_Reference_System_Code
.br
Gravity_Reference_System
.br
Gravity_Corrections_Applied
.br
Gravity_Departure_Base_Station
.br
Gravity_Departure_Base_Station_Name
.br
Gravity_Arrival_Base_Station
.br
Gravity_Arrival_Base_Station_Name
.br
Number_of_Ten_Degree_Identifiers
.br
Ten_Degree_Identifier
.br
Additional_Documentation_1
.br
Additional_Documentation_2
.br
Additional_Documentation_3
.br
Additional_Documentation_4
.br
Additional_Documentation_5
.br
Additional_Documentation_6
.br
Additional_Documentation_7
.br
.SH EXAMPLES
To generate an MGD77 header from A77 input, try
.br
.sp
\fBmgd77header\fP km0201 \fB\-H\fP kmheaderitems.txt -Mf > km0201.h77
.br
.SH "SEE ALSO"
.IR mgd77list (1),
.IR mgd77manage (1),
.IR mgd77path (1),
.IR mgd77track (1)
.IR x2sys_init (1)
.SH REFERENCES
Wessel, P., and W. H. F. Smith, 2014, The Generic Mapping Tools (GMT) version
4.5.12 Technical Reference & Cookbook, SOEST/NOAA.
.br
Wessel, P., and W. H. F. Smith, 1998, New, Improved Version of Generic Mapping
Tools Released, EOS Trans., AGU, 79 (47), p. 579.
.br
Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Mapping Tools
Released, EOS Trans., AGU, 76 (33), p. 329.
.br
Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Mapping Tools
Released, http://www.agu.org/eos_elec/95154e.html, Copyright 1995 by the
American Geophysical Union.
.br
Wessel, P., and W. H. F. Smith, 1991, Free Software Helps Map and Display Data,
EOS Trans., AGU, 72 (41), p. 441.
.br
The Marine Geophysical Data Exchange Format - "MGD77", see
\fIhttp://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt\fP
.br