swift_too
moduleswift_too
moduleswifttools
version 2.4swifttools
2.4.8 / swift_too
1.2.16July 1st, 2022: Bug fix release
swifttools
2.4.7 / swift_too
1.2.15June 27th, 2022: Bug fix release
quiet
option wasn't available in Swift_Data
and only worked in Jupyter Notebooks.swifttools
2.4.6 / swift_too
1.2.14June 24th, 2022: Bug fix and new feature release
Fix issue in Swift_Data
where fetch
argument was not working.
Add match
argument to Swift_Data
which allows user to filter on filenames using unix-style filename pattern matches. Multiple matches can be passed as a list, and files matching any of the matches will be downloaded.
swifttools
2.4.5 / swift_too
1.2.13June 16th, 2022: Bug fix release
swifttools
2.4.4 / swift_too
1.2.12May 2nd, 2022: Bug fix release.
swifttools
2.4.3 / swift_too
1.2.11May 2nd, 2022: Bug fix release.
Fixed crash related to keyring
module on macOS, where module was called non-interactively or over an ssh login.
Other minor code cleanups.
swifttools
2.4.2 / swift_too
1.2.10April 1st, 2022: Added Swift_SAA
method for calculating times when Swift is inside the South Atlantic Anomaly (SAA). Bug fix.
Swift_SAA
AKA SAA
class added for calculating SAA passage times for the Spacecraft definition of SAA (default) or an estimate of the Burst Alert Telescope SAA passage times.
Fix issue where running clock_correct
multiple times could cause issues with times.
swifttools
2.4.1 / swift_too
1.2.9March 29th, 2022: Bug fix release
begin
and end
properties of GUANO
entries were not being set.swifttools
2.4 / swift_too
1.2.8March 28th, 2022: Added clock correction through both Swift_Clock
class and universal clock_correct()
method.
Swift_Clock
that for a time in either Swift Time, UTC Time or Mission Elapsed Time (MET), will return an object containing all three, along with the Universal Time Correction Factor (UTCF) that is used to correct Swift Time to UTC. The UTCF corrects for both Swift's clock drift and for any leap seconds.clock_correct()
method to classes that return dates. Using this you can add UTCF to any returned time, and thereofer MET, UTC and Swift Time using the met
, utc
and swift
attributes.swiftdatetime
which is an extended version of datetime that is either based on Swift Time or UTC Time. swiftdatetime
act like datetimes, except that you can now obtain MET, UTC, UTCF or Swift Time using the met
, utc
, utc
or swift
attributes. In additionthe frommet
classmethod allows you to construct a swiftdatetime
from an MET. isutc
parameter defines if the basis of the swiftdatetime
is UT time or Swift Time. Standard datetime
arithmetic can be performed, however UTCF is not propogated.GUANO
query results are now clock corrected by default, to avoid confusion.swifttools
2.3.1 / swift_too
1.2.7February 7th, 2022: swift_too
module updated to 1.2.7 with the following updates / fixes:
Swift_Data
to download from the Space Science Data Center in Italy. Set itsdc = True
to download from Italian site, uksdc = True
from the UK site. Default is to download from the HEASARC (US site).Swift_GUANO
that could crash.swifttools
2.3 / swift_too
1.2.6February 3rd , 2022: swift_too
module updated to 1.2.5. Add new classes designed to make access to Swift SDC data easier, provide an API for accessing GUANO and universal name resolution. Here are the details of the upgrade
Swift_GUANO
. This class and it's support classes allow for querying data generated by the Gamma-Ray Urgent Archiver for Novel Opportunities (GUANO).Swift_Data
. This class makes downloading of Swift data from the USA and UK Swift Data Centers easy.Swift_Resolve
. For a give source name, this returns the coordinates as resolved by various name resolvers.Swift_Resolve
class, passing name
parameter to classes that take coordinates (including Swift_TOO
) will now automatically resolve the name to ra
, dec
and skycoord
(if astropy
is installed).Swift_ObsQuery
you can omit the Swift_
and use the more simple ObsQuery
.shared_secret
is None
, that can occur when username != 'anonymous'
.swifttools
2.2.2 / swift_too
1.2.4January 24th, 2022: Bug fix release.
swifttools
2.2 / swift_too
1.2.3December 17th, 2021: swifttools
2.2. Updates made in response to feedback from original release, and various quality of life improvements. Also new products can be fetched from the TOO API, details below.
keyring
support. If you have keyring
installed and it works on your system, your shared_secret
will be saved to it when you first pass it as an argument. On subsequent uses, you can give just your username
.SkyCoord
support. astropy
SkyCoord
objects can be returned instead of RA and Dec from any Class now, if astropy
is installed. Note astropy
will not be installed as a dependency of swifttools.anonymous
, meaning that requests can now be made without passing username
and shared_secret
at all.Swift_TOO_Requests
support. This new request allows for the querying of approved Swift TOO requests sent to Swift by yourself and others. The approved XRT/BAT/UVOT modes and exposure time are reported. You can also choose to retrieve detailed information from the TOO Request, including justification texts. However, this detailed information is only available for TOOs you submitted.Swift_Calendar
support. In this version you may retrieve calendar information for any TOO. These are automatically attached to entries in a Swift_TOO_Requests
entry. The Calendar shows all planned observations for a TOO, along with an estimate of how much time was actually observed during the calendar window. Note that this is different from the Swift Plan, insofar as the Swift Calendar lists requested observations and can go much farther into the future. However, due to Swift's oversubscription, and other issues, even if an object is in the Calendar, that is not guarantee that Swift will observe it on that day, only that it is in the queue to be observed.ra_point
and dec_point
renamed to ra_object
and dec_object
. These attributes give the RA/Dec of the object that was the intended target of an observation. We note that the original choice of using ''point'' to indicate this is not consistent with other missions where ''point'' is used to indicate where the telescope pointed. For now, these new variables are simply aliases of ra_point
and dec_point
. These will be deprecated upon the release of the next API version (1.3), but not necessarily the next release of swifttools
. API version will only be updated if compatibility of the API format needs to be broken, and every effort will be made to make API changes transparent to swifttools
module users.