# spacepy.pybats.bats.BatsLog

class `spacepy.pybats.bats.``BatsLog`(filename, starttime=(2000, 1, 1, 0, 0, 0), keep_case=True, *args, **kwargs)

  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)

    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 associated `spacepy.pybats.kyoto.KyotoDst` or `spacepy.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.