Usage

Getting Started

To get started with autoNICER, you'll want to establish a location on your machine that you want store NICER data (If you do not already have one).

Navigate to this location from your terminal and this will be your working directory. You should call autoNICER from by typing autonicer.

Please ensure that the drive on your machine has enough disk memory as NICER datasets can be quite large (>25GBs) and will create some temporary files throughout the data reduction, so also make sure to leave yourself some extra room!

Downloading and Reducing Data

1. Call autoNICER

    autonicer
   

2. You will be prompted to enter the name of the source object you wish with to query the nicermastr catalog for. Enter the name of the source you wish to retrieve data for.

    Target: PSR_B0531+21 (As an example)
   

Quick Tip: If you are encountering issues with the source name resolving, ensure the following at the HEASARC archive (https://heasarc.gsfc.nasa.gov/db-perl/W3Browse/w3browse.pl):

1. The source name resolves in the browse search (Enter the source name in the search box @ the link above and make sure it doesn't give you an error)
2. When issuing the search query at the link above make sure NICER has observed the source you wish to pull data for, and make sure that data is publicly available.

Note: In some cases the api will take a few days to update once an OBSID dataset becomes publicly available.

3. Next you will be prompted to set the barycenter, compression, and logging options that will apply to each NICER dataset you retrieve and reduce. All are set with a simple y/n and the default values if nothing is entered are in square brackets.

    Apply Bary-Center Correction: [y] 
    Compress XTI files (.gz): [y] 
    Write Output Log: [n] 
   

If file compression is selected all ufa.evt files will be compressed into gzips.

If the output log option is selected, a .csv file will be written out and will record the full path to either the barycenter corrected mpu7_cl.evt file or the non-barycenter corrected mpu7_cl.evt file (depending on whether a barycenter correction was performed or not).

4. From this point if everything resolves correctly you should see the autoNICER prompt.

    autoNICER >
   

The autoNICER prompt will allow you to begin selecting OBSIDs that you wish to retrieve and reduce. It may be useful to have the HEASARC archive (https://heasarc.gsfc.nasa.gov/db-perl/W3Browse/w3browse.pl) and nicermastr open in a web browser to see all the OBSIDs available for selection.

To select an OBSID you wish to gather and reduce simply enter that OBSID into the autoNICER prompt.

    autoNICER > 3013010102 

If the OBISD is found it will be queued up for retrieval and reduction once you are done selecting the OBSIDs you want retrieved and reduced.

You are encouraged to add as many or as few OBSIDs as you want. The whole point of autoNICER is to help you gather and reduce as much NICER data as you want!

Each OBSID entry into the autoNICER prompt that is then queued up will be on standby until you enter the command done into the autoNICER prompt. This will allow you to remove OBSIDs you may have mistakenly added or will allow you to add more OBISDs.

To see all the OBSIDs you can enter sel as seen below, which will list all OBSIDs currently in the queue.

    autoNICER > sel

If you made a mistake with your previous OBSID entry, you can remove the previous OBSID you entered with the command back... i.e.

    autoNICER > back

If you really messed up and just want to start over but with the same source target and settings you can enter rm all into the command prompt which will clear the entire queue... i.e.

    autoNICER > rm all

Using Existing Data