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 it may take ~48 hours for the api 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 bracket.

    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 >
   

Using Existing Data