FgcmCalibrateTractTask¶
FgcmCalibrateTractTask will run the full fgcmcal processing cycle on a single tract with multi-band coverage.
Note that the results will not be as robust as a full global calibration because of the limited ability to tract instrumental changes from observations in a single tract.
Running FgcmCalibrateTractTask requires a look-up table generated by FgcmMakeLutTask.
FgcmCalibrateTractTask uses FgcmBuildStarsTask to extract stars from individual calexp source catalog files.
If sourceTable_visit parquet tables are available, use of FgcmCalibrateTractTableTask is recommended in place of this task.
FgcmCalibrateTractTask is available as a command-line task, fgcmCalibrateTract.py.
Processing summary¶
FgcmCalibrateTractTask runs the full fgcmcal processing, from building star lists to fitting to the output of final products.
Specifically, it will:
Build the star lists: FgcmBuildStarsTask
Run the fitter until convergence: FgcmFitCycleTask
Output the final data products: FgcmOutputProductsTask
fgcmCalibrateTract.py command-line interface¶
fgcmCalibrateTract.py REPOPATH [@file [@file2 ...]] [--output OUTPUTREPO | --rerun RERUN] [--id] [other options]
Key arguments:
REPOPATHThe input Butler repository’s URI or file path.
Key options:
--id:The data IDs to process. The
tractmust be specified.
See also
See Command-line task argument reference for details and additional options.
Python API summary¶
from lsst.fgcmcal.fgcmCalibrateTract import FgcmCalibrateTractTask
-
class
FgcmCalibrateTractTask Calibrate a single tract using fgcmcal
...
-
attribute
config Access configuration fields and retargetable subtasks.
-
method
run Run the calibrations for a single tract with fgcm
...
-
method
runDataRef Run full FGCM calibration on a single tract, including building star list, fitting multiple cycles, and making outputs
...
See also
See the FgcmCalibrateTractTask API reference for complete details.
Butler datasets¶
When run as the fgcmCalibrateTract.py command-line task, or directly through the runDataRef method, FgcmCalibrateTractTask obtains datasets from the input Butler data repository and persists outputs to the output Butler data repository.
Note that configurations for FgcmCalibrateTractTask, and its subtasks, affect what datasets are persisted and what their content is.
Input datasets¶
cameraCamera geometry and detector object
fgcmLookupTableFGCM look-up table produced by FgcmMakeLutTask
Output datasets¶
fgcm_starsReference catalog of standard stars. See FgcmOutputProductsTask
fgcm_photoCalib_tractOne
fgcm_photoCalib_tractphotometric calibration file is output for each visit / ccd / tract.transmission_atmosphere_fgcm_tractOne atmospheric transmission curve is output for each visit.
Retargetable subtasks¶
fgcmBuildStars¶
- Default
- Field type
Task to load and match stars for fgcm
fgcmOutputProducts¶
- Default
- Field type
Task to output fgcm products
Configuration fields¶
convergenceTolerance¶
Tolerance on repeatability convergence (per band)
doDebuggingPlots¶
Make plots for debugging purposes?
fgcmFitCycle¶
- Data type
- Field type
Config to run a single fgcm fit cycle
maxFitCycles¶
Maximum number of fit cycles
Examples¶
fgcmCalibrateTract.py /datasets/hsc/repo --rerun <rerun name> --id visit=26024^26028^26032^26036^26044^26046^26048^26050^26058^26060^26062^26070^26072^26074^26080^26084^26094^23864^23868^23872^23876^23884^23886^23888^23890^23898^23900^23902^23910^23912^23914^23920^23924^28976^1258^1262^1270^1274^1278^1280^1282^1286^1288^1290^1294^1300^1302^1306^1308^1310^1314^1316^1324^1326^1330^24494^24504^24522^24536^24538^23212^23216^23224^23226^23228^23232^23234^23242^23250^23256^23258^27090^27094^27106^27108^27116^27118^27120^27126^27128^27130^27134^27136^27146^27148^27156^380^384^388^404^408^424^426^436^440^442^446^452^456^458^462^464^468^470^472^474^478^27032^27034^27042^27066^27068 ccd=0..8^10..103 tract=9615