IPP Software Navigation Tools IPP Links Communication Pan-STARRS Links

Changes between Initial Version and Version 1 of PSPSFlags


Ignore:
Timestamp:
Oct 3, 2012, 11:06:45 PM (14 years ago)
Author:
heather
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • PSPSFlags

    v1 v1  
     1There is a flag page here:  http://web01.psps.ifa.hawaii.edu/psps-trac/wiki/PSPSFAQ which is out of date. much information on flags located
     2
     3Some decent description of the flags (but warning these are out of date, just use for more explanations than given below)
     4 * [wiki:IPP_DVO_Bitmasks]
     5 * [wiki:CMF_PS1_V3]
     6
     7
     8
     9Here is the short version (who has flags and where they come from)
     10
     11|| type ||      flags column name  ||   definition||
     12|| single-frame detections ||   infoFlag ||      DVO dbflags << 32 | smf  FLAGS||
     13|| stack detections ||  infoFlag        || cmf  FLAGS2 << 32 | cmf  FLAGS||
     14|| objects ||   objInfoFlag ||   FLAGS from the DVO 'average'||
     15|| objects ||   xFlag ||         FLAGS from the DVO 'secfilt'||
     16
     17* dvo flags come from: http://svn.pan-starrs.ifa.hawaii.edu/trac/ipp/browser/trunk/Ohana/src/libdvo/include/dvo.h
     18
     19* smf/cmf flags come from: http://svn.pan-starrs.ifa.hawaii.edu/trac/ipp/browser/trunk/psModules/src/objects/pmSourceMasks.h
     20
     21Below is each of the current flags (for sa9)
     22
     23 == !DetectionFull.infoFlags (these are the dvo dbflags << 32) ==
     24{{{
     25          ID_MEAS_NOCAL          = 0x00000001,  // detection ignored for this analysis (photcode, time range) -- internal only
     26          ID_MEAS_POOR_PHOTOM    = 0x00000002,  // detection is photometry outlier                                               
     27          ID_MEAS_SKIP_PHOTOM    = 0x00000004,  // detection was ignored for photometry measurement                               
     28          ID_MEAS_AREA           = 0x00000008,  // detection near image edge                                                 
     29          ID_MEAS_POOR_ASTROM    = 0x00000010,  // detection is astrometry outlier                                               
     30          ID_MEAS_SKIP_ASTROM    = 0x00000020,  // detection was ignored for astrometry measurement                               
     31          ID_MEAS_USED_OBJ       = 0x00000040,  // detection was used during update objects
     32          ID_MEAS_USED_CHIP      = 0x00000080,  // detection was used during update chips (XXX this probably does not make it into the db)
     33          ID_MEAS_BLEND_MEAS     = 0x00000100,  // detection is within radius of multiple objects
     34          ID_MEAS_BLEND_OBJ      = 0x00000200,  // multiple detections within radius of object
     35          ID_MEAS_UNDEF_3        = 0x00000400,  // unused
     36          ID_MEAS_UNDEF_4        = 0x00000800,  // unused
     37          ID_MEAS_BLEND_MEAS_X   = 0x00001000,  // detection is within radius of multiple objects across catalogs                   
     38          ID_MEAS_ARTIFACT       = 0x00002000,  // detection is thought to be non-astronomical                               
     39          ID_MEAS_UNDEF_5        = 0x00004000,  // unused
     40          ID_MEAS_PHOTOM_UBERCAL = 0x00008000,  // externally-supplied zero point from ubercal analysis
     41          ID_MEAS_STACK_PRIMARY  = 0x00010000,  // externally-supplied zero point from ubercal analysis                             
     42}}}
     43
     44 == !DetectionFull.infoFlags (these are FLAGs from smf) ==
     45
     46 === FLAGS ===
     47
     48 {{{
     49    PM_SOURCE_MODE_DEFAULT                = 0x00000000, ///< Initial value: resets all bits
     50    PM_SOURCE_MODE_PSFMODEL               = 0x00000001, ///< Source fitted with a psf model (linear or non-linear)
     51    PM_SOURCE_MODE_EXTMODEL               = 0x00000002, ///< Source fitted with an extended-source model
     52    PM_SOURCE_MODE_FITTED                 = 0x00000004, ///< Source fitted with non-linear model (PSF or EXT; good or bad)
     53    PM_SOURCE_MODE_FAIL                   = 0x00000008, ///< Fit (non-linear) failed (non-converge, off-edge, run to zero)
     54    PM_SOURCE_MODE_POOR                   = 0x00000010, ///< Fit succeeds, but low-SN, high-Chisq, or large (for PSF -- drop?)
     55    PM_SOURCE_MODE_PAIR                   = 0x00000020, ///< Source fitted with a double psf
     56    PM_SOURCE_MODE_PSFSTAR                = 0x00000040, ///< Source used to define PSF model
     57    PM_SOURCE_MODE_SATSTAR                = 0x00000080, ///< Source model peak is above saturation
     58    PM_SOURCE_MODE_BLEND                  = 0x00000100, ///< Source is a blend with other sources
     59    PM_SOURCE_MODE_EXTERNAL               = 0x00000200, ///< Source based on supplied input position
     60    PM_SOURCE_MODE_BADPSF                 = 0x00000400, ///< Failed to get good estimate of object's PSF
     61    PM_SOURCE_MODE_DEFECT                 = 0x00000800, ///< Source is thought to be a defect
     62    PM_SOURCE_MODE_SATURATED              = 0x00001000, ///< Source is thought to be saturated pixels (bleed trail)
     63    PM_SOURCE_MODE_CR_LIMIT               = 0x00002000, ///< Source has crNsigma above limit
     64    PM_SOURCE_MODE_EXT_LIMIT              = 0x00004000, ///< Source has extNsigma above limit
     65    PM_SOURCE_MODE_MOMENTS_FAILURE        = 0x00008000, ///< could not measure the moments
     66    PM_SOURCE_MODE_SKY_FAILURE            = 0x00010000, ///< could not measure the local sky
     67    PM_SOURCE_MODE_SKYVAR_FAILURE         = 0x00020000, ///< could not measure the local sky variance
     68    PM_SOURCE_MODE_BELOW_MOMENTS_SN       = 0x00040000, ///< moments not measured due to low S/N
     69    PM_SOURCE_MODE_BIG_RADIUS             = 0x00100000, ///< poor moments for small radius, try large radius
     70    PM_SOURCE_MODE_AP_MAGS                = 0x00200000, ///< source has an aperture magnitude
     71    PM_SOURCE_MODE_BLEND_FIT              = 0x00400000, ///< source was fitted as a blend
     72    PM_SOURCE_MODE_EXTENDED_FIT           = 0x00800000, ///< full extended fit was used
     73    PM_SOURCE_MODE_EXTENDED_STATS         = 0x01000000, ///< extended aperture stats calculated
     74    PM_SOURCE_MODE_LINEAR_FIT             = 0x02000000, ///< source fitted with the linear fit
     75    PM_SOURCE_MODE_NONLINEAR_FIT          = 0x04000000, ///< source fitted with the non-linear fit
     76    PM_SOURCE_MODE_RADIAL_FLUX            = 0x08000000, ///< radial flux measurements calculated
     77    PM_SOURCE_MODE_SIZE_SKIPPED           = 0x10000000, ///< size could not be determined
     78    PM_SOURCE_MODE_ON_SPIKE               = 0x20000000, ///< peak lands on diffraction spike
     79    PM_SOURCE_MODE_ON_GHOST               = 0x40000000, ///< peak lands on ghost or glint
     80    PM_SOURCE_MODE_OFF_CHIP               = 0x80000000, ///< peak lands off edge of chip
     81}}}
     82
     83 == !StackDetectionFull.infoFlags (FLAGS2 << 32 | FLAGS ) ==
     84
     85 === FLAGS ===
     86
     87 {{{
     88    PM_SOURCE_MODE_DEFAULT                = 0x00000000, ///< Initial value: resets all bits
     89    PM_SOURCE_MODE_PSFMODEL               = 0x00000001, ///< Source fitted with a psf model (linear or non-linear)
     90    PM_SOURCE_MODE_EXTMODEL               = 0x00000002, ///< Source fitted with an extended-source model
     91    PM_SOURCE_MODE_FITTED                 = 0x00000004, ///< Source fitted with non-linear model (PSF or EXT; good or bad)
     92    PM_SOURCE_MODE_FAIL                   = 0x00000008, ///< Fit (non-linear) failed (non-converge, off-edge, run to zero)
     93    PM_SOURCE_MODE_POOR                   = 0x00000010, ///< Fit succeeds, but low-SN, high-Chisq, or large (for PSF -- drop?)
     94    PM_SOURCE_MODE_PAIR                   = 0x00000020, ///< Source fitted with a double psf
     95    PM_SOURCE_MODE_PSFSTAR                = 0x00000040, ///< Source used to define PSF model
     96    PM_SOURCE_MODE_SATSTAR                = 0x00000080, ///< Source model peak is above saturation
     97    PM_SOURCE_MODE_BLEND                  = 0x00000100, ///< Source is a blend with other sources
     98    PM_SOURCE_MODE_EXTERNAL               = 0x00000200, ///< Source based on supplied input position
     99    PM_SOURCE_MODE_BADPSF                 = 0x00000400, ///< Failed to get good estimate of object's PSF
     100    PM_SOURCE_MODE_DEFECT                 = 0x00000800, ///< Source is thought to be a defect
     101    PM_SOURCE_MODE_SATURATED              = 0x00001000, ///< Source is thought to be saturated pixels (bleed trail)
     102    PM_SOURCE_MODE_CR_LIMIT               = 0x00002000, ///< Source has crNsigma above limit
     103    PM_SOURCE_MODE_EXT_LIMIT              = 0x00004000, ///< Source has extNsigma above limit
     104    PM_SOURCE_MODE_MOMENTS_FAILURE        = 0x00008000, ///< could not measure the moments
     105    PM_SOURCE_MODE_SKY_FAILURE            = 0x00010000, ///< could not measure the local sky
     106    PM_SOURCE_MODE_SKYVAR_FAILURE         = 0x00020000, ///< could not measure the local sky variance
     107    PM_SOURCE_MODE_BELOW_MOMENTS_SN       = 0x00040000, ///< moments not measured due to low S/N
     108    PM_SOURCE_MODE_BIG_RADIUS             = 0x00100000, ///< poor moments for small radius, try large radius
     109    PM_SOURCE_MODE_AP_MAGS                = 0x00200000, ///< source has an aperture magnitude
     110    PM_SOURCE_MODE_BLEND_FIT              = 0x00400000, ///< source was fitted as a blend
     111    PM_SOURCE_MODE_EXTENDED_FIT           = 0x00800000, ///< full extended fit was used
     112    PM_SOURCE_MODE_EXTENDED_STATS         = 0x01000000, ///< extended aperture stats calculated
     113    PM_SOURCE_MODE_LINEAR_FIT             = 0x02000000, ///< source fitted with the linear fit
     114    PM_SOURCE_MODE_NONLINEAR_FIT          = 0x04000000, ///< source fitted with the non-linear fit
     115    PM_SOURCE_MODE_RADIAL_FLUX            = 0x08000000, ///< radial flux measurements calculated
     116    PM_SOURCE_MODE_SIZE_SKIPPED           = 0x10000000, ///< size could not be determined
     117    PM_SOURCE_MODE_ON_SPIKE               = 0x20000000, ///< peak lands on diffraction spike
     118    PM_SOURCE_MODE_ON_GHOST               = 0x40000000, ///< peak lands on ghost or glint
     119    PM_SOURCE_MODE_OFF_CHIP               = 0x80000000, ///< peak lands off edge of chip
     120}}}
     121
     122 === FLAGS2 ===
     123
     124{{{
     125    PM_SOURCE_MODE2_DEFAULT               = 0x00000000, ///< Initial value: resets all bits
     126    PM_SOURCE_MODE2_DIFF_WITH_SINGLE      = 0x00000001, ///< diff source matched to a single positive detection
     127    PM_SOURCE_MODE2_DIFF_WITH_DOUBLE      = 0x00000002, ///< diff source matched to positive detections in both images
     128    PM_SOURCE_MODE2_MATCHED               = 0x00000004, ///< diff source matched to positive detections in both images
     129    PM_SOURCE_MODE2_ON_SPIKE              = 0x00000008, ///< > 25% of (PSF-weighted) pixels land on diffraction spike
     130    PM_SOURCE_MODE2_ON_STARCORE           = 0x00000010, ///< > 25% of (PSF-weighted) pixels land on starcore
     131    PM_SOURCE_MODE2_ON_BURNTOOL           = 0x00000020, ///< > 25% of (PSF-weighted) pixels land on burntool
     132    PM_SOURCE_MODE2_ON_CONVPOOR           = 0x00000040, ///< > 25% of (PSF-weighted) pixels land on convpoor
     133    PM_SOURCE_MODE2_PASS1_SRC             = 0x00000080, ///< source detected in first pass analysis
     134    PM_SOURCE_MODE2_HAS_BRIGHTER_NEIGHBOR = 0x00000100, ///< peak is not the brightest in its footprint
     135    PM_SOURCE_MODE2_BRIGHT_NEIGHBOR_1     = 0x00000200, ///< flux_n / (r^2 flux_p) > 1
     136    PM_SOURCE_MODE2_BRIGHT_NEIGHBOR_10    = 0x00000400, ///< flux_n / (r^2 flux_p) > 10
     137    PM_SOURCE_MODE2_DIFF_SELF_MATCH       = 0x00000800, ///< positive detection match is probably this source
     138    PM_SOURCE_MODE2_SATSTAR_PROFILE       = 0x00001000, ///< saturated source is modeled with a radial profile
     139}}}
     140
     141== Object.objInfoFlags ==
     142
     143{{{
     144  ID_STAR_FEW       = 0x00000001, // used within relphot: skip star
     145  ID_STAR_POOR      = 0x00000002, // used within relphot: skip star
     146  ID_PROPER         = 0x00000400, // star with large proper motion
     147  ID_TRANSIENT      = 0x00001000, // is this mutually exclusive with USNO?
     148  ID_VARIABLE       = 0x00002000, // not currently set?
     149  ID_ASTEROID       = 0x00002000, // identified with an asteroid
     150  ID_BAD_OBJECT     = 0x00004000, // if all measurements are bad, set this bit
     151  ID_MOVING         = 0x00008000, // is a moving object
     152  ID_ROCK           = 0x0000a000, // 0x8000 + 0x2000
     153  ID_GHOST          = 0x0000c001, // 0x8000 + 0x4000 + 0x0001
     154  ID_TRAIL          = 0x0000c002, // 0x8000 + 0x4000 + 0x0002
     155  ID_BLEED          = 0x0000c003, // 0x8000 + 0x4000 + 0x0003
     156  ID_COSMIC         = 0x0000c004, // 0x8000 + 0x4000 + 0x0004
     157  ID_STAR_FIT_AVE   = 0x00010000, // average position fitted
     158  ID_STAR_FIT_PM    = 0x00020000, // proper motion fitted
     159  ID_STAR_FIT_PAR   = 0x00040000, // parallax fitted
     160  ID_STAR_USE_AVE   = 0x00080000, // average position used (not PM or PAR)
     161  ID_STAR_USE_PM    = 0x00100000, // proper motion used (not AVE or PAR)
     162  ID_STAR_USE_PAR   = 0x00200000, // parallax used (not AVE or PM)
     163  ID_STAR_NO_ASTROM = 0x00400000, // mean astrometry could not be measured
     164  ID_OBJ_EXT        = 0x01000000, // extended in our data (eg, PS)
     165  ID_OBJ_EXT_ALT    = 0x02000000, // extended in external data (eg, 2MASS)
     166  ID_OBJ_GOOD       = 0x04000000, // good-quality measurement in our data (eg,PS)
     167  ID_OBJ_GOOD_ALT   = 0x08000000, // good-quality measurement in  external data (eg, 2MASS)
     168}}}
     169
     170== Object.xFlags ==
     171{{{
     172 ID_SECF_STAR_FEW    = 0x00000001, // used within relphot: skip star
     173 ID_SECF_STAR_POOR   = 0x00000002, // used within relphot: skip star
     174 ID_SECF_USE_SYNTH   = 0x00000004, // synthetic photometry used in average measurement
     175 ID_SECF_USE_UBERCAL = 0x00000008, // synthetic photometry used in average measurement
     176 ID_SECF_HAS_PS1     = 0x00000010, // PS1 photometry used in average measurement
     177 ID_SECF_HAS_STACK   = 0x00000020, // PS1 stack photometry exists
     178 ID_PHOTOM_PASS_0    = 0x00000100, // average magnitude calculated in 0th pass
     179 ID_PHOTOM_PASS_1    = 0x00000200, // average magnitude calculated in 1th pass
     180 ID_PHOTOM_PASS_2    = 0x00000400, // average magnitude calculated in 2th pass
     181 ID_PHOTOM_PASS_3    = 0x00000800, // average magnitude calculated in 3th pass
     182 ID_PHOTOM_PASS_4    = 0x00001000, // average magnitude calculated in 4th pass
     183 ID_SECF_OBJ_EXT     = 0x01000000, // extended in this band
     184}}}
     185
     186
     187
     188
     189