Usage

doglobalhs label=<label> starttime=<starttime> totaltime=<totaltime>
[optionalparam=<value> ...]


Description

The doglobalhs script runs the specified steps of the globalhs pipeline in 
sequence for a given label.  It takes arguments in the form of name=value 
with no spaces allowed.  Under normal conditions, it is the only tool 
necessary to run globalhs modules.  It runs a number of other scripts: 
dosht, doshtcheck, doretilen, dodscopyn, doretile1, dodscopy1, domkgaps, 
dogapfill, dogfgaps, dopow, dopowslice, dopkbgn, and doinvert.  For an 
overview of each of these scripts, see their synopsis.  For details, see 
the full globalhs documentation.


Required Parameters

starttime - the beginning of the time period to be analyzed, typically
given as an offset from the MDI epoch of 1993.01.01_00:00:00_TAI (e.g. a
day number suffixed with 'd'), but date strings are also allowed.

totaltime - the total amount of time to be analyzed, given as a string,
such as '72d' or '48h'.  This string will be parsed by the program
durcon, the documentation for which can be found on its man page.

label - a string that labels a particular way of running the pipeline. 
It should uniquely map to the set of all input parameters needed by all 
modules in the pipeline.  This is implemented as parameter file 
templates located in $JSOCROOT/proj/globalhs/scripts/parmtemplate/.  For 
a complete explanation see the full globalhs documentation.


Optional Parameters

lmin - minimum spherical harmonic degree to compute, default 0

lmax - maximum spherical harmonic degree to compute, default 300

lchunk - number of l's to chunk together for short timeseries, default 40

firststep - string corresponding to first processing step desired, default 'sht'

laststep - string corresponding to last processing step desired, default 'pkbgn'

The allowed values for firststep and laststep are 'sht', 'shtcheck', 
'retilen', 'dscopyn', 'retile', 'retile1', 'dscopy1', 'mkgaps', 'gapfill', 
'gfgaps', 'pow', 'slice', 'pkbgn', and 'invert'.  For a complete 
explanation see the full globalhs documentation.

lchunk1 - passed as lchunk to dosht and lchunkin to doretilen, defaults to lchunk

lchunk2 - passed as lchunkout to doretilen and lchunkin to doretile1, defaults to lchunk

lchunk3 - passed as lchunkout to doreilte1, defaults to 1

lchunk4 - passed as lchunk to dogapfill and dopow, defaults to 10

lchunk5 - passed as lchunk to dopowslice, defaults to lchunk4

timechunk - defaults to '1d', which means one day

timechunk1 - passed as timechunk to dosht, defaults to timechunk

timechunk2 - passed as timechunk to doretilen, defaults to '12d'.

powtotaltime - passed as totaltimeout to dopow and dopowslice, defaults
to totaltime, which is always passed as totaltimein to these scripts.

powstartoffset - passed as startoffset to dopow and dopowslice, given as
a string, defaults to '0d'.

slicestep - passed as slicestep to dopowslice, given as a string,
defaults to '3d'.

topdir - top level directory in which to make working directories, 
defaults to '/tmp28'.

The remaining parameters control how jobs are submitted to the computing 
cluster for each of the processing steps.  They are passed to the 
scripts started by doglobalhs via environment variables.

retnjobs - sets GLOBALHS_RETNJOBS, read by doretile1
tsfnjobs - sets GLOBALHS_TSFNJOBS, read by dogapfill
pownjobs - sets GLOBALHS_POWNJOBS, read by dopow and dopowslice
pkbnjobs - sets GLOBALHS_PKBNJOBS, read by doiter called by dopkbgn

The above parameters specify the number of jobs to sumbit at one time 
for each step.  The number of jobs submitted by dosht and doretilen 
depends on the values of totaltime and timechunk passed to them.

v2tjobsthreshold - sets GLOBALHS_V2TJOBTHRESHOLD, read by dosht
retjobsthreshold - sets GLOBALHS_RETJOBTHRESHOLD, read by doretilen and doretile1
tsfjobsthreshold - sets GLOBALHS_TSFJOBTHRESHOLD, read by dogapfill
powjobsthreshold - sets GLOBALHS_POWJOBTHRESHOLD, read by dopow and dopowslice
pkbjobsthreshold - sets GLOBALHS_PKBJOBTHRESHOLD, read by doiter called by dopkbgn

The above parameters specify the job threshold for each step.  The 
number of jobs of a particular type must fall below this number before 
more jobs of that type may be submitted.

v2tqueue - sets GLOBALHS_V2TQUEUE, read by dosht
retqueue - sets GLOBALHS_RETQUEUE, read by doretilen and doretile1
tsfqueue - sets GLOBALHS_TSFQUEUE, read by dogapfill
powqueue - sets GLOBALHS_POWQUEUE, read by dopow and dopowslice
pkbqueue - sets GLOBALHS_PKBQUEUE, read by doiter called by dopkbgn

The above parameters specify the queue to which each processing step 
will submit jobs.