Fields_status.txt

The ASCII file /home/xmmssc/public_html/xidops/fields_status.txt contains information about what data is available and is used by IDL and PHP scripts to perform the XID analysis and display the results.

Whenever new data is added the file should be updated. Each line corresponds to one field. The header line and an example line are shown below. Note the header line is not exactly split up as the field lines are.

fieldname:GO;Xray Source List;list;expt.;25;52;24;41;57:Xray Image,25,52,24,41,
57:ApmCat:DSS Images,gen1,poss2 r,poss2 b:WFC Data,plots,merged,i,z,r,g,U:
CIRSI Data,list,image:Directory:RA<br>(J2000):Dec<br>(J2000):bII<br>(deg)

LOCKMAN HOLE:Y fits/,Y gh/;FITS xmmout.fits,GH gh.txt;0,0;Y,N;Y,Y;Y,Y;Y,Y;N,N:
n25-img.fits,n52-img.fits,n24-img.fits,n41-img.fits,n57-img.fits:poss1:Y,Y,Y:
izrgulockman_*.mer,r219698,r219697,r219699,r219779,r219778:LH.cat.fits,LH.fits:
/~xmmssc/internal/lockman-hole/:10 52 40.80 :+57 27 16.2:+53.15

The lines have been artificially cut so they fit in the page. Also there would be no blank lines between fields (although a # at the beginning of the line causes it to be ignored).

In this case almost all the information that can be available is. Fields are separated by `:' and within that by `;' then/or `,'. As a rule, `N' signifies the information is not available, 'S' that it is there but not yet ready for XID work and `Y' that it is available and processed.

• The first field contains the field name, in upper case (or the sorting by field name in some display tables doesn't work properly). As a rule I have generally separated numbers from letters ( i.e. `A 399' rather than `A399').
• The next field contains information about the X-ray source list(s). It is split into sub--fields by `;'.
  • The first sub--field should contain `N' if there is no source list, `Y' followed by a space and the name of the subdirectory where output specific to that source list will be stored if there is a list (don't forget trailing slash). Note that if there is more than one source list, information relevant to the second is separated form the first by a `,' within each sub--field. One can also have `S' instead of `Y' if the data is know to have been taken but no source list is available yet.
  • The next sub--field contains the type of source list in upper case letters, which will be used to differentiate multiple lists in the PHP tables, followed by a space and the relevant file name (file name only, not path, the scripts assume it has been correctly placed in the right subdirectory). If there is no source list this sub--field should contain `N', if it is not ready it should start with `S'.
  • The next sub--field contains the X-ray exposure time in seconds. If you have a source list but you don't know the exposure time put `0', it will show up as `?' in the PHP tables.
  • The next sub--field contains information about which bands are present in the list and is split into five bands by `,', each containing `Y' or `N' as appropriate. The bands are: 25: 0.2 to 0.5 keV, 52: 0.5 to 2 keV, 24: 2 to 4.5 keV, 41: 4.5 to 10 keV, 57: ?. If your source list does not contain the 52 band, pretend it does so the scripts work (if the source list is ASCII, label on of the flux / counts columns accordingly).
• The next field contains the file names of X-ray images, separated by `,'. Use `N' if there is no image for that band. Note there may be an image even if there is no data for that band in the source list, and vice--versa.
• The next field specifies if there is an AMPCAT source list or not and whether it is POSS1 or UKST data. Set to `N' (no list), `S comment' (not there yet) or simply `ukst' or `poss1' if the source list is present.
• The next field contains info about the presence of DSS images (UKST or POSS1 red, POSS2 red, POSS2 blue, separated by `,'. Set to either `N', `S' or `Y'.
• The next field contains information about WFC data, separated into sub--fields by `,'.
  • The first sub--field should contain the name if the merged source list (of the form `name_*.mer') or `N' or `S name_*.mer' if the list exists but is not available yet.
  • The next five sub--fields contain, for each of the five bands, `r******' where `******' is the run number, or `N' or `S r******' if the data has been taken but lists and images are not available yet. It is assumed that both images and source lists are available together.
• The next field should contain the CIRSI source list and image names (separated by `,').
• The next field should contain the URL of the xidops directory.

  Omit the http://www.ast.cam.ac.uk bit and include the trailing slash.

  For example: /xmmssc/xidops/textbffield/.

• The next three fields contain RA, Dec (J2000) and galactic latitude (degrees) to the precision shown in the example.

Once the directories to receive the input files have been created and the files placed in them, and fields_status.txt has been updated as shown above, a subdirectory for each source list should be created, named as indicated in fields_status.txt. The XID work is then ready to begin.