Man Page  mc4campaigns


 USAGE:
           (1) mc4campaigns [opts] [-t]

           (2) mc4campaigns [opts] -C <campaign> [-t]
           (3) mc4campaigns [opts] -C <campaign> -s fnmodl
 
           To be launched from the directory where the drop.smp-files
           are stored.
 
   Version (1) processes all campaigns that are marked
               with #C records in the file ./campaigns.lst
               If a #D <campaign> record is found, the column after
               the campaign code specifies the sampling interval
               for the MC-file.
 
   Version (2) processes one campaign, combining all #C -records.
               The campaign may be split into sub-campaigns;
               the selector might select one ore all.
 
   Version (3) processes one campaign, splitting the job into
               one for each .drop.smp -file
 
 PURPOSE:
           The script calls ./agsmp2mc (symlink to ~/TD/agsmp2mc)
           collecting the #C records from campaigns.lst
 
           If you want to group/split the processing, introduce
           sub-campaigns in campaigns.lst by adding a running
           number to the campaign id.
           And don't forget to add a #D record for each
           sub-campaign that sets the time increment.
 
           If you must split the processing into one job for each
           drop.smp-file, use the -s option.

           You may have to produce two output sets, one
           for calibration combining as much data as there is;
           and a set on a per-project basis if e.g. seismometer
           data is used and time precision to the seconds level
           is essential. See the additional remarks at the end of
           the help text.
 
 OPTIONS:
 
 -C <str>    - Select a specific campaign or set of
               campaigns. The string may be a common substring
               of a range of #C -entries, field 1.

 -smpdir <sdir>
             - the directory where the .drop.smp and
.drop.smp.tse files
               are stored (output from scgts4ag). Default = .
 
 -DD <ddir>  - the directory that contains the drift smp-files.
               Default ddir is identical to the default value in agsmp2mc.
 
 -O <destd>  - the destination directory for mc-files and jump-files
               Default = ../Allcamps/d
 
 -DS | -DY   - Adds a column with the drift series. Select the drift method:
               SCG-samples (S) or 
parametric (Y)
               Default: Don't include drift
.
 
 -JA         - append the jump file

 -dt p       - inforce a sampling interval p [s] on the mc-file produced.
               Default is taken from the smp-files.
               The campaigns.lst file must be consistent,
               check / update the #D -record !
           p = LIST  - will retrieve the value from ../Allcamps/campaigns.lst
 
 -t          - for a test. The script shows the commands that
               would be issued.
 -MX <sed-arg>
             - For campaign-wide MC-files, the default names will include
               %I by default. The sed-arg, the editing argument to sed,
               can change this to include more mark-up. The default is
               s/%I/%I-%N/ in order to show the number of projects.
              
 
 -s <fnmodl> - create a script ./mc4projects for one project at
               a time with results in an mc-file the name of which is
               created according to <fnmdl>; default = AGSG_%D_%I_%O%L
               See agsmp2mc -h for file name construction elements.
               (The default uses %D = date, %I = instrument,
               %O = orientation, %L the last character of the
               input file name after stripping .drop.smp)
 
 -T          - invoke agsmp2mc with the -t option (test)
 
 -J          - invoke agsmp2mc with the -J option (renew jump files)
 

A file ./agsmp2mc.problems is created with information on eventually low retrieval quotas in the sampling process. In such a case, analyse whether sampling schemes make jumps (worst case if e.g. a 10 - 20 - 30 scheme jumps to 05 - 15 - 25 seconds sample times). The doubt margin of readfuf/readfmd cannot cope with this. The best way is to force 1/2 of the auto-detected sampling interval upon the output mc-file:

In a/Allcamps/campaigns.lst add a line
 #D <campaign> <dt>

EXAMPLE:
           cd ~/TD/a/Allsmp
           mc4campaigns -DY -dt 1 -C 200907a



.bye