[[PageOutline]]

== Running The !AddStar Pantasks ==

There are a few steps to get addstar running:

 * the DVODB that is specified can be either a real path, or one defined in site.config. 
 * make sure the appropriate modules are loaded in addstar's pantasks (addstar.pro, minidvodb.pro, survey.pro)

 === Setting up the !ThreePi catalog ===

NOTE: the order is important here due to a yet-to-be-resolved bug:

{{{
add.minidvodb ThreePi THREEPI.V1.MINI THREEPI.V1 1 GPC1
add.label ThreePi
}}}

now wait for there to be a {{{minidovdbRun}}} entry, then

{{{
survey.add.addstar ThreePi.nightlyscience THREEPI.V1 ThreePi 
}}}

 === A general example ===

 * survey.add.addstar (label) (dvodb) (minidvodb_group)
 * add.minidvodb (minidvodb_group) (minidvodb) (dvodb) (interval days) (camera)
 * add.label (minidvodb_group)

 === The arguments ===

 * (label) - the label used in addtool -definebyquery to queue the exposures
 * (dvodb) - defined in site.config. This is where the final (merged) dvodb will go.
 * (minidvodb_group) - Something sensibly chosen (in this case, ThreePi). It works a bit like a label here.
 * (minidvodb) - defined in site.config - this is the location where the minidvodbs will go. 
 * (interval days) - how long before the minidvodbs are rotated (there is also a cut of 500 exposures)
 * (camera) - I couldn't figure out how to suck this out of the available information, and it's needed, so you have to provide it on the command line.

 === What each task does ===

 * {{{survey.add.addstar}}} - queues the exposures using addtool
 * {{{add.minidvodb}}} - creates the minidvodbRun table (like a survey task). This is essential for minidvodbs
 * {{{add.label}}} - it's pantasks - it needs to know what label to munch on.

For other purposes, for example, if you have a different sort of query (not one that can be queued off of the label), do not run survey.add.addstar. You will still need add.minidvodb and add.label. You will have to queue the exposures using addtool 

 === Some 'by hand' examples ===

To queue a minidvodb (which will get merged automatically)


{{{
 addtool -definebyquery -destreaked -comment %SAS% -set_dvodb ROYSAS.V1 -set_minidvodb_group RoySAS.V1 -set_minidvodb -set_label RoySAS.V1 -dbname gpc1
}}}

in pantasks


{{{
add.minidvodb RoySAS.V1  ROYSAS.V1   ROYSAS.V1 1 GPC1
add.label RoySAS.V1 
}}}

To queue something that is not a minidvodb (this is not tested yet - I need to test it):

{{{
addtool -definebyquery -destreaked -comment %SAS% -set_dvodb ROYSAS.V1 -set_label RoySAS.V1 -dbname gpc1
}}}

in pantasks 

{{{
add.label RoySAS.V1 
}}}