ENH: Added a DMSP SSJ instrument

[aburrell]

Description

Added an instrument for the DMSP SSJ auroral boundary index data. This data is stored in yearly files, and requires an update to pysat to work correctly. It also revealed a local bug in the general download function.

Type of change

Please delete options that are not relevant.

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality or documentation)
• This change requires a documentation update

How Has This Been Tested?

import datetime as dt
import pysat
import pysatMadrigal as pymad

stime = dt.datetime(2014, 3, 26)
ssj = pysat.Instrument(inst_module=pymad.instruments.dmsp_ssj, tag='abi')
ssj.download(start=stime)
ssj.load(date=stime)

ssj.data

Yields

                    year  month   day  ...  eqb_prb_kp  sat_id   epowq
2014-03-26 00:06:45  2014.0    3.0  26.0  ...       0.911    17.0  2170.0
2014-03-26 00:29:37  2014.0    3.0  26.0  ...       0.868    18.0  2181.0
2014-03-26 00:38:45  2014.0    3.0  26.0  ...       0.881    17.0  2171.0
2014-03-26 00:41:33  2014.0    3.0  26.0  ...       0.622    16.0  2160.0
2014-03-26 00:45:33  2014.0    3.0  26.0  ...       0.946    18.0  2181.0
...                     ...    ...   ...  ...         ...     ...     ...
2014-03-26 23:33:17  2014.0    3.0  26.0  ...       0.940    16.0  2161.0
2014-03-26 23:38:09  2014.0    3.0  26.0  ...       0.768    17.0  2170.0
2014-03-26 23:42:29  2014.0    3.0  26.0  ...       0.913    18.0  2180.0
2014-03-26 23:43:29  2014.0    3.0  26.0  ...       0.892    16.0  2161.0
2014-03-26 23:51:33  2014.0    3.0  26.0  ...       0.911    17.0  2170.0

[131 rows x 22 columns]

Test Configuration

• Operating system: OS X Big Sur
• Version number: Python 3.9
• Any details about your local setup that are relevant: requires pysat (BUG: listing files with a yearly cadence pysat#1079)

Checklist:

• Make sure you are merging into the develop (not main) branch
• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have linted the files updated in this pull request
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• [N/A] My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged and published in downstream modules
• Add a note to CHANGELOG.md, summarizing the changes

If this is a release PR, replace the first item of the above checklist with the
release checklist on the pysat wiki:
https://github.com/pysat/pysat/wiki/Checklist-for-Release

[aburrell]

Requires pysat 3.1.0 release