* The instrument will be one of shocnawe (SHA) or shocndisbelief (SHD). These are used to create the directory and filename in the /data directory. The directory will be of the form /data/<telescope>/<instrument>/<YYYY>/<MMDD>, and the file of the form <instrument>_<YYYYMMDD>.<index>.fits. From this, the instrument name can be determined. At the moment, SHA is the SHOC instrument mounted on the 74inch.
* You will be prompted for an index to use. NB: '''make sure there is no existing file with the same index that will be overwritten''' The script will scan the target directory and list the existing files. Choose and index which isn't used(one option is to use an index like 3a , if index 3 exists). In other words, if files such as SHA_20150403.0004.fits and SHA_20150403.0005.fits, choosing either index 4 or 5 will result in that file being overwritten. If you choose as index 4a or 5a, the files will not be overwritten.
====Header Keyword Conversion====
With the release of the new, web-based software there have been changes in the naming of some of the FITS keywords. The keywords are documented in the table below:
{| border="1" cellpadding="5" cellspacing="0" class="wikitable"
!|Old Keyword
!|New Keyword
|-
|HIERARCH EMREALGAIN
|EMREALGN
|-
|HIERARCH COUNTCONVERTMODE
|CNTCVTMD
|-
|HIERARCH COUNTCONVERT
|CNTCVT
|-
|HIERARCH DETECTIONWAVELENGTH
|DTNWLGTH
|-
|HIERARCH SENSITIVITY
|SNTVTY
|-
|HIERARCH SPURIOUSNOISEFILTER
|SPSNFLTR
|-
|HIERARCH THRESHOLD
|THRSHLD
|-
|HIERARCH PHOTONCOUNTINGENABLED
|PCNTENLD
|-
|HIERARCH NOTHRESHOLDS
|NSETHSLD
|-
|HIERARCH PHOTONCOUNTINGTHRESHOLD1
|PTNTHLD1
|-
|HIERARCH PHOTONCOUNTINGTHRESHOLD2
|PTNTHLD2
|-
|HIERARCH PHOTONCOUNTINGTHRESHOLD3
|PTNTHLD3
|-
|HIERARCH PHOTONCOUNTINGTHRESHOLD4
|PTNTHLD4
|-
|HIERARCH AVERAGINGFILTERMODE
|AVGFTRMD
|-
|HIERARCH AVERAGINGFACTOR
|AVGFCTR
|-
|HIERARCH FRAMECOUNT
|FRMCNT
|}
A script is provided to convert back and forth between the two versions of the keywords. This is useful when working with a data pipeline that is still based on the old version of the keywords or to make old data compatible with a new data pipeline. The script can be used as follows from a command line terminal:
$ convert_headers.py mydatacube.fits
This will convert the keywords in an old data cube to the new version. To convert the keywords back to the old version, run the script with the "revert" option:
$ convert_headers.py --revert mydatacube.fits
In both cases the program will try to save the updated cube to a file with the same name, but postfixed with "_converted". So, "mydatacube_converted.fits" in the examples above. If the file already exists, you will be asked if you want to overwrite the file. If you do not want to overwrite the file you will be given the opportunity to enter a different file name. Multiple files can be converted at once, but providing a list of them when running the program:
$ convert_headers.py cube1.fits cube2.fits cube3.fits
=== In-depth Information ===