Functions to help create jointcal tests by generating fake data.
lsst.jointcal.testUtils.createFakeCatalog |
( |
|
num, |
|
|
|
bbox, |
|
|
|
fluxFieldName, |
|
|
|
skyWcs = None , |
|
|
|
refCat = False |
|
) |
| |
Return a fake minimally-useful catalog for jointcal.
Parameters
----------
num : `int`
Number of sources to put in the catalogs. Should be
a square, to have sqrt(num) centroids on a grid.
bbox : `lsst.geom.Box2I`
Bounding Box of the detector to populate.
fluxFieldName : `str`
Name of the flux field to populate in the catalog, without `_instFlux`
(e.g. "slot_CalibFlux").
skyWcs : `lsst.afw.geom.SkyWcs` or None, optional
If supplied, use this to fill in coordinates from centroids.
refCat : `bool`, optional
Return a ``SimpleCatalog`` so that it behaves like a reference catalog?
Returns
-------
catalog : `lsst.afw.table.SourceCatalog`
A populated source catalog.
Definition at line 191 of file testUtils.py.
lsst.jointcal.testUtils.createFakeCcdImage |
( |
|
butler, |
|
|
|
visit, |
|
|
|
num, |
|
|
|
fluxFieldName, |
|
|
|
photoCalibMean = 1e-2 , |
|
|
|
photoCalibErr = 1.0 , |
|
|
|
fakeDetectorId = 12 , |
|
|
|
fakeWcs = None , |
|
|
|
fakeVisitInfo = None |
|
) |
| |
Create a fake CcdImage by making a fake catalog.
Parameters
----------
butler : `lsst.daf.butler.Butler`
Butler to load metadata from.
visit : `int`
Visit identifier to build a butler dataId.
num : `int`
Number of sources to put in the catalogs. Should be
a square, to have sqrt(num) centroids on a grid.
fluxFieldName : `str`
Name of the flux field to populate in the catalog, without `_instFlux`
(e.g. "slot_CalibFlux").
photoCalibMean : `float`, optional
Value to set for calibrationMean in the created PhotoCalib.
Note: this value is 1/instFluxMag0, so it should be less than 1.
photoCalibErr : `float`, optional
Value to set for calibrationErr in the created PhotoCalib.
fakeDetectorId : `int`, optional
Use this as the detectorId in the returned CcdImage.
fakeWcs : `lsst.afw.geom.SkyWcs`, optional
A SkyWcs to use instead of one read from disk.
fakeVisitInfo : `lsst.afw.image.VisitInfo`, optional
A VisitInfo to use instead of one read from disk.
Returns
-------
struct : `lsst.pipe.base.Struct`
Result struct with components:
- `catalog` : Catalogs containing fake sources
(`lsst.afw.table.SourceCatalog`).
- `ccdImage` : CcdImage containing the metadata and fake sources
(`lsst.jointcal.CcdImage`).
- `bbox` : Bounding Box of the image (`lsst.geom.Box2I`).
- `skyWcs` : SkyWcs of the image (`lsst.afw.geom.SkyWcs`).
Definition at line 133 of file testUtils.py.
lsst.jointcal.testUtils.createTwoFakeCcdImages |
( |
|
num1 = 4 , |
|
|
|
num2 = 4 , |
|
|
|
seed = 100 , |
|
|
|
fakeDetectorId = 12 , |
|
|
|
photoCalibMean1 = 1e-2 , |
|
|
|
photoCalibMean2 = 1.2e-2 , |
|
|
|
fakeWcses = (None, None) , |
|
|
|
fakeVisitInfos = (None, None) |
|
) |
| |
Return two fake ccdImages built on CFHT Megacam metadata.
If ``num1 == num2``, the catalogs will align on-sky so each source will
have a match in the other catalog.
This uses the butler dataset stored in `tests/data/cfht_minimal` to
bootstrap the metadata.
Parameters
----------
num1, num2 : `int`, optional
Number of sources to put in the first and second catalogs. Should be
a square, to have sqrt(num) centroids on a grid.
seed : `int`, optional
Seed value for np.random.
fakeDetectorId : `int`, optional
Sensor identifier to use for both CcdImages. The wcs, bbox, photoCalib, etc.
will still be drawn from the CFHT ccd=12 files, as that is the only
testdata that is included in this simple test dataset.
photoCalibMean1, photoCalibMean2: `float`, optional
The mean photometric calibration to pass to each ccdImage construction.
Note: this value is 1/instFluxMag0, so it should be less than 1.
fakeWcses : `list` [`lsst.afw.geom.SkyWcs`], optional
The SkyWcses to use instead of the ones read from disk.
fakeWcses : `list` [`lsst.afw.image.VisitInfo`], optional
The VisitInfos to use instead of the ones read from disk.
Returns
-------
struct : `lsst.pipe.base.Struct`
Result struct with components:
- `camera` : Camera representing these catalogs
(`lsst.afw.cameraGeom.Camera`).
- `catalogs` : Catalogs containing fake sources
(`list` of `lsst.afw.table.SourceCatalog`).
- `ccdImageList` : CcdImages containing the metadata and fake sources
(`list` of `lsst.jointcal.CcdImage`).
- `bbox` : Bounding Box of the image (`lsst.geom.Box2I`).
- 'fluxFieldName' : name of the instFlux field in the catalogs ('str').
Definition at line 52 of file testUtils.py.
lsst.jointcal.testUtils.fillCatalog |
( |
|
schema, |
|
|
|
num, |
|
|
|
bbox, |
|
|
|
centroidKey, |
|
|
|
xErrKey, |
|
|
|
yErrKey, |
|
|
|
shapeKey, |
|
|
|
fluxFieldName, |
|
|
|
skyWcs = None , |
|
|
|
fluxErrFraction = 0.05 , |
|
|
|
refCat = False |
|
) |
| |
Return a catalog populated with fake, but reasonable, sources.
Centroids are placed on a uniform grid, errors are normally distributed.
Parameters
----------
schema : `lsst.afw.table.Schema`
Pre-built schema to make the catalog from.
num : `int`
Number of sources to put in the catalog.
bbox : `lsst.geom.Box2I`
Bounding box of the ccd to put sources in.
centroidKey : `lsst.afw.table.Key`
Key for the centroid field to populate.
xErrKey : `lsst.afw.table.Key`
Key for the xErr field to populate.
yErrKey : `lsst.afw.table.Key`
Key for the yErr field to populate.
shapeKey : `lsst.afw.table.Key`
Key for the shape field to populate.
fluxFieldName : `str`
Name of the flux field to populate in the catalog, without `_instFlux`
(e.g. "slot_CalibFlux").
skyWcs : `lsst.afw.geom.SkyWcs` or None, optional
If supplied, use this to fill in coordinates from centroids.
fluxErrFraction : `float`, optional
Fraction of instFlux to use for the instFluxErr.
refCat : `bool`, optional
Return a ``SimpleCatalog`` so that it behaves like a reference catalog?
Returns
-------
catalog : `lsst.afw.table.SourceCatalog`
The filled catalog.
Definition at line 236 of file testUtils.py.