IPP DVO Database Flags

In the DVO Database, there are bitmask flags associated with images, objects, and detection measurements. For the measurements, there are two types of flags: those generated by the pixel-level photometry analysis (photflags) and those associated with analyses made within the database itself (dbflags).

For photflags, a summary can be found at the following location, along with an explanation of using bitmask flags.

http://svn.pan-starrs.ifa.hawaii.edu/trac/ipp/wiki/IPP_Detection_Bitmasks

For dbflags, the values are listed below and defined in:

http://svn.pan-starrs.ifa.hawaii.edu/trac/ipp/browser/trunk/Ohana/src/libdvo/include/dvo.h

The dbflags are not currently (2010.10.15) as firmly defined or set as the photflags: Many of the values are not currently used and may be changed or replaced.

Flags associated with measurements (mextract.dbflags == mextract.db_flags)

	  ID_MEAS_NOCAL        = 0x00000001,  // detection ignored for this analysis (photcode, time range) -- internal only
	  ID_MEAS_POOR_PHOTOM  = 0x00000002,  // detection is photometry outlier                                                 
	  ID_MEAS_SKIP_PHOTOM  = 0x00000004,  // detection was ignored for photometry measurement                                 
	  ID_MEAS_AREA         = 0x00000008,  // detection near image edge                                                   
	  ID_MEAS_POOR_ASTROM  = 0x00000010,  // detection is astrometry outlier                                                 
	  ID_MEAS_SKIP_ASTROM  = 0x00000020,  // detection was ignored for astrometry measurement                                 
	  ID_MEAS_USED_OBJ     = 0x00000040,  // detection was used during opdate objects                                   
	  ID_MEAS_USED_CHIP    = 0x00000080,  // detection was used during update chips                                     
	  ID_MEAS_BLEND_MEAS   = 0x00000100,  // detection is within radius of multiple objects                             
	  ID_MEAS_BLEND_OBJ    = 0x00000200,  // multiple detections within radius of object                                 
	  ID_MEAS_UNDEF_3      = 0x00000400,  // unused                                                                     
	  ID_MEAS_UNDEF_4      = 0x00000800,  // unused                                                                     
	  ID_MEAS_BLEND_MEAS_X = 0x00001000,  // detection is within radius of multiple objects across catalogs             
	  ID_MEAS_ARTIFACT     = 0x00002000,  // detection is thought to be non-astronomical                                 
	  ID_MEAS_UNDEF_5      = 0x00004000,  // unused                                                                     
	  ID_MEAS_UNDEF_6      = 0x00008000,  // unused                                                                     

Flags associated with average objects (avextract.flags == avextract.objflags == avextract.obj_flags == mextract.objflags == mextract.obj_flags)

	  ID_STAR_FEW     = 0x00000001, // used within relphot: skip star
	  ID_STAR_POOR    = 0x00000002, // used within relphot: skip star
	  ID_PROPER       = 0x00000400, // star with large proper motion
	  ID_TRANSIENT    = 0x00001000, // is this mutually exclusive with USNO? 
	  ID_VARIABLE     = 0x00002000, // not currently set?
	  ID_ASTEROID     = 0x00002000, // identified with an asteroid
	  ID_BAD_OBJECT   = 0x00004000, // if all measurements are bad, set this bit
	  ID_MOVING       = 0x00008000, // is a moving object
	  ID_ROCK         = 0x0000a000, // 0x8000 + 0x2000
	  ID_GHOST        = 0x0000c001, // 0x8000 + 0x4000 + 0x0001
	  ID_TRAIL        = 0x0000c002, // 0x8000 + 0x4000 + 0x0002
	  ID_BLEED        = 0x0000c003, // 0x8000 + 0x4000 + 0x0003 
	  ID_COSMIC       = 0x0000c004, // 0x8000 + 0x4000 + 0x0004 
	  ID_STAR_FIT_AVE = 0x00010000, // average position fitted
	  ID_STAR_FIT_PM  = 0x00020000, // proper motion fitted
	  ID_STAR_FIT_PAR = 0x00040000, // parallax fitted
	  ID_STAR_USE_AVE = 0x00080000, // average position used (not PM or PAR)
	  ID_STAR_USE_PM  = 0x00100000, // proper motion used (not AVE or PAR)
	  ID_STAR_USE_PAR = 0x00200000, // parallax used (not AVE or PM)
	  ID_OBJ_EXT      = 0x01000000, // extended in our data (eg, PS)
	  ID_OBJ_EXT_ALT  = 0x02000000, // extended in external data (eg, 2MASS)
	  ID_OBJ_GOOD     = 0x04000000, // good-quality measurement in our data (eg, PS)
	  ID_OBJ_GOOD_ALT = 0x08000000, // good-quality measurement in external data (eg, 2MASS)

Flags associated with Secfilt

  ID_SECF_STAR_FEW    = 0x00000001, // used within relphot: skip star
  ID_SECF_STAR_POOR   = 0x00000002, // used within relphot: skip star
  ID_SECF_USE_SYNTH   = 0x00000004, // synthetic photometry used in average measurement
  ID_SECF_USE_UBERCAL = 0x00000008, // synthetic photometry used in average measurement
  ID_PHOTOM_PASS_0    = 0x00000100, // average magnitude calculated in 0th pass
  ID_PHOTOM_PASS_1    = 0x00000200, // average magnitude calculated in 1th pass
  ID_PHOTOM_PASS_2    = 0x00000400, // average magnitude calculated in 2th pass
  ID_PHOTOM_PASS_3    = 0x00000800, // average magnitude calculated in 3th pass
  ID_PHOTOM_PASS_4    = 0x00001000, // average magnitude calculated in 4th pass
  ID_SECF_OBJ_EXT     = 0x01000000, // extended in this band

Flags associated with images (imextract.flags == imextract.imflags)

	  ID_IMAGE_NEW          = 0x00000000,  /* no calibrations yet attempted */
	  ID_IMAGE_PHOTOM_NOCAL = 0x00000001,  /* user-set value used within relphot: ignore */
	  ID_IMAGE_PHOTOM_POOR  = 0x00000002,  /* relphot says image is bad (dMcal > limit) */
	  ID_IMAGE_PHOTOM_SKIP  = 0x00000004,  /* user-set value: assert that this image has bad photometry */
	  ID_IMAGE_PHOTOM_FEW   = 0x00000008,  /* currently too few measurements for photometry */
	  ID_IMAGE_ASTROM_NOCAL = 0x00000010,  /* user-set value used within relastro: ignore */
	  ID_IMAGE_ASTROM_POOR  = 0x00000020,  /* relastro says image is bad (dR,dD > limit) */
	  ID_IMAGE_ASTROM_FAIL  = 0x00000040,  /* relastro fit diverged, fit not applied */
	  ID_IMAGE_ASTROM_SKIP  = 0x00000080,  /* user-set value: assert that this image has bad astrometry */
	  ID_IMAGE_ASTROM_FEW   = 0x00000100,  /* currently too few measurements for astrometry */