Package: autonicer
autoNICERA piece of software that allows for the automated retrieval, and default data reduction of NICER data. This software was developed to automate the retrieval of NICER data and perform standardized data reduction on the retrieved NICER data.
This project unaffiliated with the NICER team, NASA, the Goddard Space Flight Center (GSFC), and HEASARC. Thus, under no circumstances should anyone consider this project endorsed or recommended by the afformentioned agencies and organizations.ContributingAnyone considering contribiting to this project is encouraged to do so.
Constributing can be something as small as submitting issues you have found or requesting enhancements. Your feedback is incredibly valuable for improving the project.
All that is asked is that if you wish to contribute code please reach out in one way or another to nkphysics(Nick Space Cowboy), and submit a pull request.
And if you want to see what's being worked on for future versions check out the open issues tagged as enhancements or the open projects under the projects tab.Thank you.DisclaimerThis software is licensed under the Apache 2.0 license, so it is free and open source for you to use.
This project unaffiliated with the NICER team, NASA, the Goddard Space Flight Center (GSFC), and HEASARC. Under no circumstances should anyone consider this project endorsed or recommended by the afformentioned agencies and organizations.Watch a video Tutorial on how to use autoNICERAfter v1.0.2 I a made a video going over autoNICER and demoing some of its functionality.
See it here:https://youtu.be/q23dvn3Da7QFor more in depth instructions and documentation check out the wiki:https://github.com/nkphysics/autoNICER/wikiPre-Requisite SoftwareHEASoft v6.29c, v6.30.1, RECOMMENDED v6.31.1https://heasarc.gsfc.nasa.gov/docs/software/lheasoft/A video tutorial on how to generally install heasoft can be found here:https://youtu.be/3-gobnSEuDoRemote CALDBhttps://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/caldb_remote_access.htmlA video tutorial on how to setup Remote CALDB can be found here:https://youtu.be/s01DF0cwOvMwgetInstallationFor standard non-dev use cases download via pip.$ pip3 install autonicerOR$ pip install autonicerFor development cases:Clone the repocd into the project directoryRunpoetry installto install the needed dependenciesStart working!Basic UsageInitialize HEASoft.Go to the HEASARC archive in your web browser and query the NICERMASTER catalog for the source of your choice.Navigate to the desired directory where you want the NICER data that will be retrieved to be stored.Run autonicer by calling the local installation (i.e.$ autonicer)Upon starting autoNICER you will be asked to input the target source that you would like to query. Input the same source that you queryed in the web browser (ex: PSR_B0531+21).Next you will be prompted to select the settings. You can select the followingIf you want a barycenter correction performedIf a .csv log of the autoNICER run is written outIf the *ufa.evt files are compressed after reductionNext you will see the following promptautoNICER >. Enter in the desired OBSID for the observation that you want retrieved and reduced. Better yet, copy the desired observation ID from the HEASARC archive and paste into the program. This will query that observation to be retrieved and processed. Typeselto see all the OBSID's you've selected. Typecycle [cycle number](not with the brackets) to select all OBSID's from a specific cycle. You can use therm [all or OBSID]orbackcommands to remove unwanted OBSID's that you may have selected by mistake. Typedonewhen you have entered in all the observation IDs you want retrieved and reduced.You will see autoNICER start retrieving the data with wget, then that will be fed directly intonicerl2, then it will be barycenter corrected and lastly compressed in a .gz format if you selected for it to happen. Selected OBSID's are retrieved and processed in series so autoNICER will move on the the next OBSID you've queryed up and give you back command of your terminal after it has retrieved and reduced all selected OBSIDs.Runautonicer --helpfor a list of CLI options