# 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, **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.

    Observed Dst is automatically fetched from the Kyoto World Data Center via the `spacepy.pybats.kyoto` module. The associated `spacepy.pybats.kyoto.KyotoDst` object, which holds the observed Dst, is stored as self.obs_dst for future use.

    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.