|
HMI Ring Diagrams
Pipeline Module Specifications
|
gentargs
Module Version
0.9 23 IV 2010
General Description
gentargs generates the lists of target latitude and longitude centers
and/or tracking ranges for a selected time for the synoptic pipeline.
Various options generate lists needed for other pipelines, in particular
the MDI "dense-pack" and "structure-pack" grids. The module output is in
the form of lines of text sent to stdout, and expected to be parsed
by a pipeline script.
Status
This version has been superseded by Version 1.0
Included in JSOC release 5.9
This version supersedes Version 0.8
The source code and Makefile are in the JSOC CVS repository
Usage
gentargs [-flags] time= TargetTime
Flags
-M use SOHO ephemeris for B0 calculation or conversion of time parameter
in calendar-clock format to Carrington time
-v run verbose
Parameters
time The target time for the grid-point calculation. The time
can be specified in either calendar-clock (YYYY.MM.DD_hh:mm:ss)
notation or in CR:CL (Carrington rotation plus central meridian
of epoch) form; the latter is recommended. The time will be rounded
to the nearest one appropriate for the grid spacings requested,
2.5 deg for the HMI synoptic set, 15 deg for the MDI packs.
Default: current time minus 120 deg of Carrington rotation.
grid Option for selection of the target list of values to be reported.
Default: discross
The following options are recognized (though not all are supported):
discross — limits for disc crossings needed for the three ring diagrams
synoptic sets
rdsyn05 — ~2°.5 centers for the target analysis time
rdsyn15 — ~7°.5 centers "
rdsyn30 — ~15° centers "
timed — 20° centers in a plate carrée grid "
mdidp — 7°.5 centers in a plate carrée grid "
mdisp — 7°.5 centers in a plate carrée grid "
rd+05 — not supported
rd+15 — not supported
rd+30 — not supported
rdx05 — not supported
rdx15 — not supported
rdx30 — not supported
rdcm05 — not supported
rdcm15 — not supported
rdcm30 — not supported
rdeq05 — not supported
rdeq15 — not supported
rdeq30 — not supported
Notes:
For the options rdsyn05 and rdsyn15, multiple pairs of lines are generated,
each corresponding to the target latitudes and longitudes in a restricted
range of latitudes. That is because it is not possible for mtrack to process
more than 300 regions at a time, and inefficient to process more than about
250. For rdsyn15, two sets of targets are generated; for rdsyn05, sixteen.
For all options other than timed, the longitudes of the target grid are
rounded to the closest value appropriate for that grid.
Because the normal output of the module is to stdout, extra information
generated by selection of the verbose flag is directed to stderr.
Sample output:
=> gentargs -v grid= mdisp
finding time corresponding to 120 deg in past: 2096:344.6
-45.0 -37.5 -30.0 -22.5 -15.0 -07.5 +00.0 +07.5 +15.0 +22.5 +30.0 +37.5 +45.0 -45.0 -37.5 -30.0 -22.5 -15.0 -07.5 +00.0 +07.5 +15.0 +22.5 +30.0 +37.5 +45.0 -45.0 -37.5 -30.0 -22.5 -15.0 -07.5 +00.0 +07.5 +15.0 +22.5 +30.0 +37.5 +45.0
210.0 210.0 210.0 210.0 210.0 210.0 210.0 210.0 210.0 210.0 210.0 210.0 210.0 225.0 225.0 225.0 225.0 225.0 225.0 225.0 225.0 225.0 225.0 225.0 225.0 225.0 240.0 240.0 240.0 240.0 240.0 240.0 240.0 240.0 240.0 240.0 240.0 240.0 240.0
=> gentargs grid= timed
-40.0 -40.0 -40.0 -40.0 -40.0 -20.0 -20.0 -20.0 -20.0 -20.0 +00.0 +00.0 +00.0 +00.0 +00.0 +20.0 +20.0 +20.0 +20.0 +20.0 +40.0 +40.0 +40.0 +40.0 +40.0
184.6 204.6 224.6 244.6 264.6 184.6 204.6 224.6 244.6 264.6 184.6 204.6 224.6 244.6 264.6 184.6 204.6 224.6 244.6 264.6 184.6 204.6 224.6 244.6 264.6
=> gentargs grid= timed time= 2010.05.02_16:00
-40.0 -40.0 -40.0 -40.0 -40.0 -20.0 -20.0 -20.0 -20.0 -20.0 +00.0 +00.0 +00.0 +00.0 +00.0 +20.0 +20.0 +20.0 +20.0 +20.0 +40.0 +40.0 +40.0 +40.0 +40.0
189.2 209.2 229.2 249.2 269.2 189.2 209.2 229.2 249.2 269.2 189.2 209.2 229.2 249.2 269.2 189.2 209.2 229.2 249.2 269.2 189.2 209.2 229.2 249.2 269.2
=> gentargs grid= rdsyn30
-60.0 -60.0 -60.0 -60.0 -60.0 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +45.0 +45.0 +45.0 +45.0 +45.0 +45.0 +45.0 +60.0 +60.0 +60.0
150.0 180.0 210.0 240.0 270.0 150.0 165.0 180.0 195.0 210.0 225.0 240.0 255.0 270.0 150.0 165.0 180.0 195.0 210.0 225.0 240.0 255.0 270.0 150.0 165.0 180.0 195.0 210.0 225.0 240.0 255.0 270.0 150.0 165.0 180.0 195.0 210.0 225.0 240.0 255.0 270.0 150.0 165.0 180.0 195.0 210.0 225.0 240.0 255.0 270.0 150.0 165.0 180.0 195.0 210.0 225.0 240.0 255.0 270.0 165.0 180.0 195.0 210.0 225.0 240.0 255.0 180.0 210.0 240.0
=> gentargs grid= rdsyn15
-75.0 -67.5 -67.5 -67.5 -67.5 -67.5 -67.5 -67.5 -60.0 -60.0 -60.0 -60.0 -60.0 -60.0 -60.0 -60.0 -60.0 -60.0 -60.0 -52.5 -52.5 -52.5 -52.5 -52.5 -52.5 -52.5 -52.5 -52.5 -52.5 -52.5 -52.5 -52.5 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -45.0 -37.5 -37.5 -37.5 -37.5 -37.5 -37.5 -37.5 -37.5 -37.5 -37.5 -37.5 -37.5 -37.5 -37.5 -37.5 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -30.0 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -22.5 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -15.0 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5 -07.5
225.0 165.0 185.0 205.0 225.0 245.0 265.0 285.0 150.0 165.0 180.0 195.0 210.0 225.0 240.0 255.0 270.0 285.0 300.0 150.0 162.5 175.0 187.5 200.0 212.5 225.0 237.5 250.0 262.5 275.0 287.5 300.0 155.0 165.0 175.0 185.0 195.0 205.0 215.0 225.0 235.0 245.0 255.0 265.0 275.0 285.0 295.0 155.0 165.0 175.0 185.0 195.0 205.0 215.0 225.0 235.0 245.0 255.0 265.0 275.0 285.0 295.0 150.0 157.5 165.0 172.5 180.0 187.5 195.0 202.5 210.0 217.5 225.0 232.5 240.0 247.5 255.0 262.5 270.0 277.5 285.0 292.5 300.0 150.0 157.5 165.0 172.5 180.0 187.5 195.0 202.5 210.0 217.5 225.0 232.5 240.0 247.5 255.0 262.5 270.0 277.5 285.0 292.5 300.0 150.0 157.5 165.0 172.5 180.0 187.5 195.0 202.5 210.0 217.5 225.0 232.5 240.0 247.5 255.0 262.5 270.0 277.5 285.0 292.5 300.0 157.5 165.0 172.5 180.0 187.5 195.0 202.5 210.0 217.5 225.0 232.5 240.0 247.5 255.0 262.5 270.0 277.5 285.0 292.5
+00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +00.0 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +07.5 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +15.0 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +22.5 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +30.0 +37.5 +37.5 +37.5 +37.5 +37.5 +37.5 +37.5 +37.5 +37.5 +37.5 +37.5 +37.5 +37.5 +45.0 +45.0 +45.0 +45.0 +45.0 +45.0 +45.0 +45.0 +45.0 +45.0 +45.0 +45.0 +45.0 +52.5 +52.5 +52.5 +52.5 +52.5 +52.5 +52.5 +52.5 +52.5 +60.0 +60.0 +60.0 +60.0 +60.0 +60.0 +60.0 +67.5 +67.5 +67.5
157.5 165.0 172.5 180.0 187.5 195.0 202.5 210.0 217.5 225.0 232.5 240.0 247.5 255.0 262.5 270.0 277.5 285.0 292.5 157.5 165.0 172.5 180.0 187.5 195.0 202.5 210.0 217.5 225.0 232.5 240.0 247.5 255.0 262.5 270.0 277.5 285.0 292.5 157.5 165.0 172.5 180.0 187.5 195.0 202.5 210.0 217.5 225.0 232.5 240.0 247.5 255.0 262.5 270.0 277.5 285.0 292.5 157.5 165.0 172.5 180.0 187.5 195.0 202.5 210.0 217.5 225.0 232.5 240.0 247.5 255.0 262.5 270.0 277.5 285.0 292.5 157.5 165.0 172.5 180.0 187.5 195.0 202.5 210.0 217.5 225.0 232.5 240.0 247.5 255.0 262.5 270.0 277.5 285.0 292.5 165.0 175.0 185.0 195.0 205.0 215.0 225.0 235.0 245.0 255.0 265.0 275.0 285.0 165.0 175.0 185.0 195.0 205.0 215.0 225.0 235.0 245.0 255.0 265.0 275.0 285.0 175.0 187.5 200.0 212.5 225.0 237.5 250.0 262.5 275.0 180.0 195.0 210.0 225.0 240.0 255.0 270.0 205.0 225.0 245.0
=> gentargs time= 1988:180
30 222.50 137.50 1
30 230.00 130.00 1
30 235.00 125.00 1
30 240.00 120.00 1 -67.5
30 242.50 117.50 1
30 245.00 115.00 3
15 215.00 145.00 1 +60.0
15 225.00 135.00 1 -75.0
15 227.50 132.50 1 +52.5
15 235.00 125.00 1 +45.0
15 240.00 120.00 2 -67.5 +37.5
15 245.00 115.00 1 +30.0
15 247.50 112.50 2 -60.0 +22.5
15 250.00 110.00 3 -52.5 +07.5 +15.0
15 252.50 107.50 6 -45.0 -37.5 -30.0 -15.0 -07.5 +00.0
15 255.00 105.00 1 -22.5
5 190.00 170.00 1 +70.0
5 207.50 152.50 1 +67.5
5 217.50 142.50 1 +65.0
5 225.00 135.00 2 -82.5 +62.5
5 227.50 132.50 1 +60.0
5 232.50 127.50 1 +57.5
5 235.00 125.00 1 +55.0
5 237.50 122.50 2 -80.0 +52.5
5 240.00 120.00 1 +50.0
5 242.50 117.50 1 +47.5
5 245.00 115.00 3 -77.5 +42.5 +45.0
5 247.50 112.50 3 -75.0 +37.5 +40.0
5 250.00 110.00 4 -72.5 +30.0 +32.5 +35.0
5 252.50 107.50 5 -70.0 +20.0 +22.5 +25.0 +27.5
5 255.00 105.00 7 -67.5 -65.0 +07.5 +10.0 +12.5 +15.0 +17.5
5 257.50 102.50 12 -62.5 -60.0 -57.5 -15.0 -12.5 -10.0 -07.5 -05.0 -02.5 +00.0 +02.5 +05.0
5 260.00 100.00 16 -55.0 -52.5 -50.0 -47.5 -45.0 -42.5 -40.0 -37.5 -35.0 -32.5 -30.0 -27.5 -25.0 -22.5 -20.0 -17.5
Changes from Previous Version
— Added options for "daily" HMI-packs of 5-, 15- and 30-deg tiles
— Changed option selection to enumerated grid argument rather
than flags; added several options for future implementation (crosses, strips)
Bugs in current version
Options rdsyn05 and rdsyn15 have not been implemented for times at which
|B0| < 3°.625
Selection of one of the unsupported options is equivalent to selection
of the discross option.
Invocation of the -M flag to use SOHO ephemerides requires the presence of
appropriate ephemeris tables at a fixed system disc location; if they are
not present, the earth ephemeris will be used. However, the ephemeris
information is only used for converting time parameter values in calendar-
clock format to CR:CL format, and for calculation of B0. The value of B0
only matters for the definition of the HMI synoptic pipeline set, not the
dense-pack and structure-pack sets appropriate for MDI. As long as queries
to the database for the input to mtrack are based on central meridian
longitude rather than time, this should be of no concern.
There may be problems parsing regular calendar-clock time strings; use of
the CR:CL format for the time value is recommended.