Skip to content

NuSTAR/nustar-clock-utils

Repository files navigation

Utilities for a precise timing calibration of NuSTAR data

Powered by Astropy Badge

Travis CI build

Installation

$ git clone https://github.com/matteobachetti/nustar-clock-utils
$ cd nustar-clock-utils
$ pip install -r requirements.txt
$ pip install .

Usage

To create a clock file

Pass the temperature table, the clock offset table, the frequency change table, and give an output file name:

This will produce the wanted clock file and a diagnostic plot in an html file called nuCclock20100101v099.html showing the scatter of clock offsets around the temperature correction, e.g.

image

To correct a single event file (deprecated)

You should have at least a (non-barycentered) event file and some temperature information. The latter can be found in the engineering housekeeping file (auxil/nuXXXXXXXXXX_eng.hk.gz) in recent observations. Otherwise the SOC can provide a comma-separated file with the temperature information. There are two ways to correct the clock data, one for legacy data (<2018:10:01) and one for recent data.

Legacy:

Recent-ish:

Very recent observation, before an update to the clock offset and clock divisor adjustment history:

The -D option specifies the clock divisor (the frequency of the quartz oscillator in the spacecraft TCXO). If unkown, give something around 24000300 and be aware that the clock will be stable but will run fast or slow.

To barycenter the corrected data, at the moment you need a tempo-format parameter file with at least the name and the coordinates.

License

This project is Copyright (c) Matteo Bachetti, Craig Markwardt and the NuSTAR team, and licensed under the terms of the BSD 3-Clause license. This package is based upon the Astropy package template which is licensed under the BSD 3-clause licence. See the licenses folder for more information.