Home| superdarn |src.bin|tk|tool| combine_grid Index

combine_grid

Syntax
combine_grid --help
combine_grid [-vb] [-r] gridnames...
combine_grid -old [-vb] [-r] gridnames...
Synopsis

Combines together grid files.

Options
--helpprint the help message and exit.
--versionprint the RST version number and exit.
-vbverbose. Log information to the console.
-rcombine with replacement. As each input record is combined together to form the output, a check is made to see if any of the data is from a station already included. If a duplicate set of vectors is found they will replace the existing vectors in the output.
gridnamesfilenames of the grdmap format files.
-oldthe input files are in the grd format file.
Description

Combines together multiple grid files to produce a single file written to standard output.

By default the output record is the simple combination of all of the input records. If two records contain data from the identical station, the two sets of vectors are both included in the output record.

The "-r" option combines with replacement so that as each input record is processed, a check is made to see if any of the vectors are from a station that has already been included. Any duplicate vectors replace the existing data in the output file.

This option is most useful when dealing with a grid file containing data from one station that is contaminated with noise. Rather than having to reprocess the entire file, the user can regenerate a new grid file for the affected station and then use the combine with replacement option to replace it in the existing grid file.

The resultant file is written to standard output.

Examples
combine_grid -old -vb 19981020.???.grd > 19981020.grd

Combines together all files called "19981020.???.grd" to produce a file called "19981020.grd". The status is logged to standard error.

combine_grid -vb -r 19991120.grdmap 19991120.gbr.grdmap > 19991120.2.grdmap

Combines with replacement the file "19991120.grdmap" and "19991120.gbr.grdmap" to produce the output file "19991120.2.grdmap".