spacepy.pybats.bats.BatsLog¶
- class spacepy.pybats.bats.BatsLog(filename, starttime=(2000, 1, 1, 0, 0, 0), keep_case=True, *args, **kwargs)[source]¶
A specialized version of
LogFile
that includes special methods for plotting common BATS-R-US log file values, such as D$_{ST}$.add_dst_quicklook
([target, loc, plot_obs, ...])Create a quick-look plot of Dst (if variable present in file) and compare against observations.
- add_dst_quicklook(target=None, loc=111, plot_obs=False, epoch=None, add_legend=True, plot_sym=False, dstvar=None, obs_kwargs={'c': 'k', 'ls': '--'}, **kwargs)[source]¶
Create a quick-look plot of Dst (if variable present in file) and compare against observations.
Like all add_* * methods in Pybats, the *target kwarg determines where to place the plot. If kwarg target is None (default), a new figure is generated from scratch. If target is a matplotlib Figure object, a new axis is created to fill that figure at subplot location loc (defaults to 111). If target is a matplotlib Axes object, the plot is placed into that axis at subplot location loc.
With newer versions of BATS-R-US, new dst-like variables are included, named ‘dst’, ‘dst-sm’, ‘dstflx’, etc. This subroutine will attempt to first use ‘dst-sm’ as it is calculated consistently with observations. If not found, ‘dst’ is used. Users may choose which value to use via the dstvar kwarg.
Observed Dst and SYM-H is automatically fetched from the Kyoto World Data Center via the
spacepy.pybats.kyoto
module. The associatedspacepy.pybats.kyoto.KyotoDst
orspacepy.pybats.kyoto.KyotoSym
object, which holds the observed Dst/SYM-H, is stored as self.obs_dst for future use. The observed line can be customized via the obs_kwargs kwarg, which is a dictionary of plotting keyword arguments.If kwarg epoch is set to a datetime object, a vertical dashed line will be placed at that time.
The figure and axes objects are returned to the user.