SwiftAuxilTemporalFinder

class gdt.missions.swift.finders.SwiftAuxilTemporalFinder(tstart, tstop=None)

Bases: SwiftTemporalFinder

Finds Swift auxiliary data that covers a given time or time range.

See SwiftTemporalFinder for details on how this class works.

Parameters:

• tstart (astropy.Time) – A time of interest or start time for a time range of interest

• tstop (astropy.Time, optional) – The stop time for a time range of interest.

Attributes Summary

cwd	The current working directory for each observation ID
files	The files that might contain data during the time or time range of interest
num_files	Number of files

Methods Summary

cd(tstart[, tstop])	Changes the directories based on a time or time range of interest.
filter(filetype, extension)	Filters the directories for the requested filetype and extension
get(download_dir, files[, verbose])	Downloads files to a directory and returns the downloaded file paths
get_attitude(download_dir[, which])	Download the spacecraft attitude (pointing) files.
get_orbit(download_dir, **kwargs)	Download the spacecraft orbit files.
ls_attitude([which])	List the spacecraft attitude (pointing) files.
ls_orbit()	List the Swift orbit files.

Attributes Documentation

cwd

The current working directory for each observation ID

Type:

(list)

files

The files that might contain data during the time or time range of interest

Type:

(list)

num_files

Number of files

Type:

(int)

Methods Documentation

cd(tstart, tstop=None)

Changes the directories based on a time or time range of interest.

Parameters:

• tstart (astropy.Time) – A time of interest or start time for a time range of interest

• tstop (astropy.Time, optional) – The stop time for a time range of interest.

filter(filetype, extension)

Filters the directories for the requested filetype and extension

Parameters:

• filetype (str) – The type of file, e.g. ‘cspec’

• extension (str) – The file extension, e.g. ‘.pha’

Returns:

(list)

get(download_dir, files, verbose=True)

Downloads files to a directory and returns the downloaded file paths

Parameters:

• download_dir (str) – The download directory

• files (list) – The list of files to download

• verbose (bool, optional) – Set to False to turn off download status

Returns:

(list) – The downloaded file paths

get_attitude(download_dir, which='best', **kwargs)

Download the spacecraft attitude (pointing) files.

Parameters:

• download_dir (str) – The download directory

• which (str) – Which attitude files to return. Options are ‘all’, ‘pat’, ‘sat’, ‘uat’, and ‘best’. Default is ‘best’. The ‘sat’ attitude files are uncorrected/unsmoothed, the ‘pat’ files are smoothed on ground, and the ‘uat’ files are calibrated using UVOT observations (when available). In terms of quality, uat > pat > sat, so ‘best’ returns the best available quality.

• verbose (bool, optional) – If True, will output the download status.

Returns:

(list) – The file paths of the downloaded files

get_orbit(download_dir, **kwargs)

Download the spacecraft orbit files.

Parameters:

• download_dir (str) – The download directory

• verbose (bool, optional) – If True, will output the download status.

Returns:

(list) – The file paths of the downloaded files

ls_attitude(which='best')

List the spacecraft attitude (pointing) files.

Parameters:

which (str) – Which attitude files to return. Options are ‘all’, ‘pat’, ‘sat’, ‘uat’, and ‘best’. Default is ‘best’. The ‘sat’ attitude files are uncorrected/unsmoothed, the ‘pat’ files are smoothed on ground, and the ‘uat’ files are calibrated using UVOT observations (when available). In terms of quality, uat > pat > sat, so ‘best’ returns the best available quality.

Returns:

(list of str)

ls_orbit()

List the Swift orbit files.

Returns:

(list of str)