Line: 1 to 1 | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
AAOmega File Format (or, which spectrum is which object?) | |||||||||||||
Line: 10 to 10 | |||||||||||||
File Extensions | |||||||||||||
Changed: | |||||||||||||
< < | The table below gives a summary of the 2dfdr output file content, for either an individual reduced frame ....red.fits files or a combined reduced frame combined_frames.fits file. The file is a standard Multi-Extension FITS file (FITS MEF). | ||||||||||||
> > | The table below gives a summary of the 2dfdr output file content, for either an individual reduced frame (....red.fits files) or a combined reduced frame (combined_frames.fits file). The file is a standard Multi-Extension FITS file (FITS MEF). | ||||||||||||
| |||||||||||||
Changed: | |||||||||||||
< < |
| ||||||||||||
> > |
| ||||||||||||
Added: | |||||||||||||
> > | The primary extension in the FITS file is a WxN image where W is the number of pixels in each spectrum, and N is the number of spectra represented. This is 400 for AAOmega data, 392 science fibres and 8 guide fibres. Unused science fibres and Sky spectra, are included in the output file along with the guide fibres spectra, even though the spectra contain no information, as this is seen to simplify book keeping, and is a small disc space overhead. In the case where multiple sets of AAOmega datasets, which contained a subset of common objects, have been combined, the format is a little more complex, and is explained separately below. | ||||||||||||
Changed: | |||||||||||||
< < | The primary extension in the MEF FITS file is a WxN image where N is the number of spectra represented. This is 400 for AAOmega data, 392 science fibres and 8 guide fibres. Unused science fibres and Sky spectra, are included in the output file along with the guide fibres spectra, even though the spectra contain no information, as this is seen to simplify book keeping, and is a small disc space overhead. In the case where multiple sets of AAOmega datasets, which contained a subset of common objects, have been combined, the format is a little more complex, and is explained separately below. The variance extension is a WxN array. Each member contains the variance for the corresponding element in the primary extension. | ||||||||||||
> > | The variance extension is also a WxN array. Each member contains the variance for the corresponding element in the primary extension. | ||||||||||||
The fibre table is described below. The extensions can be accessed in a number of ways given below. | |||||||||||||
Changed: | |||||||||||||
< < |
An Important Note on 2dF Fibre-Pivot Number and 2dfdr Fibre NumberThere are two very important, and very different, numbers needed to recover the information for which object each fibre was allocated: Fibre slit position AND 2dF Fibre-Pivot position. For the most part there is a one-to-one correspondence between these number sets. i.e. the fibre at AAOmega slit position 1 (at the bottom of the CCD image, ...red.fits[0][*,1]) will map directly to 2dF Pivot position 1, and fibre 400 will map to Pivot position 400. (Note 400 is a guide fibre and so maps to a blank space at the top of the CCD image, ...red.fits[0][*,400]). However, during manufacture or repair of the AAOmega slit units, it is possible for the order of fibres in each of the AAOmega slits to fall out of synchronization with the 2dF Pivot numbering (2 slit blocks on each plate are like this as of April 2007). It is not practical to mechanically alter either position so each of the conversion betwen the two is propagated in the binary table extension (Pivot position). In the primary image .fits[0] (and also the variance array .fits[1]) the fibre at the bottom of the image, which is the fibre at slit position 1 (...red.fits[0][*,1]), corresponds to the first row in the binary table extension .fits[2]). The table contains a column entry, PIVOT, which gives the 2dF pivot position for this fibre. This is the fibre number seen be the Configure software. The very top fibre in a CCD image corresponds to the very last entry in the binary table (which will be an AAOmega guide fibre in the case of a single AAOmega data set). There is ALWAYS a one-to-one correspondence between each spectrum position in the image and the binary table. There is typically a one-to-one correspondence between slit position and 2dF pivot position but with a number of known mismatches and discontinuities which are tracked via the PIVOT column of the binary table. | ||||||||||||
> > | The files output by 2dfdr also include data at intermediate processing steps. They are not normally used by scientist. They are described here. | ||||||||||||
Changed: | |||||||||||||
< < | Combining Multiple AAOmega Data Sets which contain a Common Subset of Targets | ||||||||||||
> > |
Combining Multiple AAOmega Data Sets containing a Common Subset of Targets | ||||||||||||
Changed: | |||||||||||||
< < | Instead of simply combining based on the fibre number in the reduced data frames (i.e. combine fibre 1 in frame 1 with fibre 1 in frame 2 etc.), the 2dfdr combine algorithm combines data based on object name. This has a number of advantages: | ||||||||||||
> > | Instead of simply combining based on the fibre number in the reduced data frames (i.e. combine fibre 1 in frame 1 with fibre 1 in frame 2 etc.), the 2dfdr combine algorithm combines data based on object name. This has some advantages: | ||||||||||||
| |||||||||||||
Changed: | |||||||||||||
< < | This can result in final combined data frames in which there are more than spectra than the instrument can produce in one exposure, so that all objects are contained, whether they are contained within every frame or only a sub-set of the frames. The first spectra will be all those from the first frame (including any unused/parked and sky fibres), while any additional spectra will be extra program (only) spectra from objects not present in the first frame. All the fibres extension information is properly propagated in this process and an extra array is added listing the actual exposure time (in seconds) for each spectrum. If the data combined are all from the same configuration there will be no difference between the new combining and the old fibre number combining (apart from that unused/parked fibres will have all their values set to zero). | ||||||||||||
> > | This can result in final combined data frames in which there are more spectra than the instrument can produce in one exposure. This is to include all objects, whether they are contained within every frame or only a sub-set of the frames. The first spectra will be all those from the first frame (including any unused/parked and sky fibres), while any additional spectra will be extra program (only) spectra from objects not present in the first frame. All the fibres extension information is properly propagated in this process. There are plans for an extra array to be added that gives the actual exposure time (in seconds) for each spectrum. If the data combined are all from the same configuration there will be no difference between the new combining and the old fibre number combining (apart from that unused/parked fibres will have all their values set to zero). | ||||||||||||
Line: 70 to 68 | |||||||||||||
| |||||||||||||
Added: | |||||||||||||
> > |
Important Note on 2dF Fibre-Pivot Number and 2dfdr Fibre NumberThere are two very important, and very different, numbers needed to recover the information for which object each fibre was allocated: Fibre slit position AND 2dF Fibre-Pivot position. For the most part there is a one-to-one correspondence between these number sets. i.e. the fibre at AAOmega slit position 1 (at the bottom of the CCD image, ...red.fits[0][*,1]) will map directly to 2dF Pivot position 1, and fibre 400 will map to Pivot position 400. (Note 400 is a guide fibre and so maps to a blank space at the top of the CCD image, ...red.fits[0][*,400]). However, during manufacture or repair of the AAOmega slit units, it is possible for the order of fibres in each of the AAOmega slits to fall out of synchronization with the 2dF Pivot numbering (2 slit blocks on each plate are like this as of April 2007). It is not practical to mechanically alter either position so each of the conversion betwen the two is propagated in the binary table extension (Pivot position). In the primary image .fits[0] (and also the variance array .fits[1]) the fibre at the bottom of the image, which is the fibre at slit position 1 (...red.fits[0][*,1]), corresponds to the first row in the binary table extension .fits[2]). The table contains a column entry, PIVOT, which gives the 2dF pivot position for this fibre. This is the fibre number seen be the Configure software. The very top fibre in a CCD image corresponds to the very last entry in the binary table (which will be an AAOmega guide fibre in the case of a single AAOmega data set). There is ALWAYS a one-to-one correspondence between each spectrum position in the image and the binary table. There is typically a one-to-one correspondence between slit position and 2dF pivot position but with a number of known mismatches and discontinuities which are tracked via the PIVOT column of the binary table. | ||||||||||||
How to Access the Fibre Table Information | |||||||||||||
Changed: | |||||||||||||
< < | This list is not exhaustive. If your favorite option is missing, send an e-mail to Rob Sharp and it will be added to the list. | ||||||||||||
> > | This list is not exhaustive. If your favorite option is missing, send an e-mail to Rob Sharp and it will be added. | ||||||||||||
With Configure | |||||||||||||
Line: 148 to 153 | |||||||||||||
Changed: | |||||||||||||
< < | -- RonHeald - 01 Jul 2007 | ||||||||||||
> > | -- RonHeald - 18 Jul 2007 |