Polar

The routines in this module can be used to load data from the Polar mission.

Magnetic Field Experiment (MFE)

pyspedas.polar.mfe(trange=['2003-10-28', '2003-10-29'], datatype='k0', suffix='', get_support_data=False, varformat=None, varnames=[], downloadonly=False, notplot=False, no_update=False, time_clip=False)

This function loads data from the Magnetic Field Experiment

Parameters:
  • trange (list of str) – time range of interest [starttime, endtime] with the format ‘YYYY-MM-DD’,’YYYY-MM-DD’] or to specify more or less than a day [‘YYYY-MM-DD/hh:mm:ss’,’YYYY-MM-DD/hh:mm:ss’]

  • datatype (str) – Data type; Valid options:

  • suffix (str) – The tplot variable names will be given this suffix. By default, no suffix is added.

  • get_support_data (bool) – Data with an attribute “VAR_TYPE” with a value of “support_data” will be loaded into tplot. By default, only loads in data with a “VAR_TYPE” attribute of “data”.

  • varformat (str) – The file variable formats to load into tplot. Wildcard character “*” is accepted. By default, all variables are loaded in.

  • varnames (list of str) – List of variable names to load (if not specified, all data variables are loaded)

  • downloadonly (bool) – Set this flag to download the CDF files, but not load them into tplot variables

  • notplot (bool) – Return the data in hash tables instead of creating tplot variables

  • no_update (bool) – If set, only load data from your local cache

  • time_clip (bool) – Time clip the variables to exactly the range specified in the trange keyword

Return type:

List of tplot variables created.

Example

import pyspedas
from pytplot import tplot
mfe_vars = pyspedas.polar.mfe(trange=['2003-10-28', '2003-10-29'])
tplot(['B_GSE', 'B_GSM'])
_images/polar_mfe.png

Electric Fields Instrument (EFI)

pyspedas.polar.efi(trange=['2003-10-28', '2003-10-29'], datatype='k0', suffix='', get_support_data=False, varformat=None, varnames=[], downloadonly=False, notplot=False, no_update=False, time_clip=False)

This function loads data from the Electric Fields Instrument

Parameters:
  • trange (list of str) – time range of interest [starttime, endtime] with the format ‘YYYY-MM-DD’,’YYYY-MM-DD’] or to specify more or less than a day [‘YYYY-MM-DD/hh:mm:ss’,’YYYY-MM-DD/hh:mm:ss’]

  • datatype (str) – Data type; Valid options:

  • suffix (str) – The tplot variable names will be given this suffix. By default, no suffix is added.

  • get_support_data (bool) – Data with an attribute “VAR_TYPE” with a value of “support_data” will be loaded into tplot. By default, only loads in data with a “VAR_TYPE” attribute of “data”.

  • varformat (str) – The file variable formats to load into tplot. Wildcard character “*” is accepted. By default, all variables are loaded in.

  • varnames (list of str) – List of variable names to load (if not specified, all data variables are loaded)

  • downloadonly (bool) – Set this flag to download the CDF files, but not load them into tplot variables

  • notplot (bool) – Return the data in hash tables instead of creating tplot variables

  • no_update (bool) – If set, only load data from your local cache

  • time_clip (bool) – Time clip the variables to exactly the range specified in the trange keyword

Return type:

List of tplot variables created.

Example

import pyspedas
from pytplot import tplot
efi_vars = pyspedas.polar.efi(trange=['2003-10-28', '2003-10-29'])
tplot(['ESPIN', 'EXY12G', 'EZ12G'])
_images/polar_efi.png

Plasma Wave Instrument (PWI)

pyspedas.polar.pwi(trange=['1997-01-03', '1997-01-04'], datatype='k0', suffix='', get_support_data=False, varformat=None, varnames=[], downloadonly=False, notplot=False, no_update=False, time_clip=False)

This function loads data from the Plasma Wave Instrument

Parameters:
  • trange (list of str) – time range of interest [starttime, endtime] with the format ‘YYYY-MM-DD’,’YYYY-MM-DD’] or to specify more or less than a day [‘YYYY-MM-DD/hh:mm:ss’,’YYYY-MM-DD/hh:mm:ss’]

  • datatype (str) – Data type; Valid options:

  • suffix (str) – The tplot variable names will be given this suffix. By default, no suffix is added.

  • get_support_data (bool) – Data with an attribute “VAR_TYPE” with a value of “support_data” will be loaded into tplot. By default, only loads in data with a “VAR_TYPE” attribute of “data”.

  • varformat (str) – The file variable formats to load into tplot. Wildcard character “*” is accepted. By default, all variables are loaded in.

  • varnames (list of str) – List of variable names to load (if not specified, all data variables are loaded)

  • downloadonly (bool) – Set this flag to download the CDF files, but not load them into tplot variables

  • notplot (bool) – Return the data in hash tables instead of creating tplot variables

  • no_update (bool) – If set, only load data from your local cache

  • time_clip (bool) – Time clip the variables to exactly the range specified in the trange keyword

Return type:

List of tplot variables created.

Example

import pyspedas
from pytplot import tplot
pwi_vars = pyspedas.polar.pwi()
tplot(['Fce', 'Fcp', 'FcO'])
_images/polar_pwi.png

Hot Plasma Analyzer Experiment (HYDRA)

pyspedas.polar.hydra(trange=['2003-10-28', '2003-10-29'], datatype='k0', suffix='', get_support_data=False, varformat=None, varnames=[], downloadonly=False, notplot=False, no_update=False, time_clip=False)

This function loads data from the Hot Plasma Analyzer Experiment

Parameters:
  • trange (list of str) – time range of interest [starttime, endtime] with the format ‘YYYY-MM-DD’,’YYYY-MM-DD’] or to specify more or less than a day [‘YYYY-MM-DD/hh:mm:ss’,’YYYY-MM-DD/hh:mm:ss’]

  • datatype (str) – Data type; Valid options:

  • suffix (str) – The tplot variable names will be given this suffix. By default, no suffix is added.

  • get_support_data (bool) – Data with an attribute “VAR_TYPE” with a value of “support_data” will be loaded into tplot. By default, only loads in data with a “VAR_TYPE” attribute of “data”.

  • varformat (str) – The file variable formats to load into tplot. Wildcard character “*” is accepted. By default, all variables are loaded in.

  • varnames (list of str) – List of variable names to load (if not specified, all data variables are loaded)

  • downloadonly (bool) – Set this flag to download the CDF files, but not load them into tplot variables

  • notplot (bool) – Return the data in hash tables instead of creating tplot variables

  • no_update (bool) – If set, only load data from your local cache

  • time_clip (bool) – Time clip the variables to exactly the range specified in the trange keyword

Return type:

List of tplot variables created.

Example

import pyspedas
from pytplot import tplot
hydra_vars = pyspedas.polar.hydra(trange=['2003-10-28', '2003-10-29'])
tplot('ELE_DENSITY')
_images/polar_hydra.png

Thermal Ion Dynamics Experiment (TIDE)

pyspedas.polar.tide(trange=['1997-01-03', '1997-01-04'], datatype='k0', suffix='', get_support_data=False, varformat=None, varnames=[], downloadonly=False, notplot=False, no_update=False, time_clip=False)

This function loads data from the Thermal Ion Dynamics Experiment / Plasma Source Investigation

Parameters:
  • trange (list of str) – time range of interest [starttime, endtime] with the format ‘YYYY-MM-DD’,’YYYY-MM-DD’] or to specify more or less than a day [‘YYYY-MM-DD/hh:mm:ss’,’YYYY-MM-DD/hh:mm:ss’]

  • datatype (str) – Data type; Valid options:

  • suffix (str) – The tplot variable names will be given this suffix. By default, no suffix is added.

  • get_support_data (bool) – Data with an attribute “VAR_TYPE” with a value of “support_data” will be loaded into tplot. By default, only loads in data with a “VAR_TYPE” attribute of “data”.

  • varformat (str) – The file variable formats to load into tplot. Wildcard character “*” is accepted. By default, all variables are loaded in.

  • varnames (list of str) – List of variable names to load (if not specified, all data variables are loaded)

  • downloadonly (bool) – Set this flag to download the CDF files, but not load them into tplot variables

  • notplot (bool) – Return the data in hash tables instead of creating tplot variables

  • no_update (bool) – If set, only load data from your local cache

  • time_clip (bool) – Time clip the variables to exactly the range specified in the trange keyword

Return type:

List of tplot variables created.

Example

import pyspedas
from pytplot import tplot
tide_vars = pyspedas.polar.tide()
tplot(['total_den', 'total_v', 'total_t'])
_images/polar_tide.png

Toroidal Imaging Mass Angle Spectrograph (TIMAS)

pyspedas.polar.timas(trange=['1997-01-03', '1997-01-04'], datatype='k0', suffix='', get_support_data=False, varformat=None, varnames=[], downloadonly=False, notplot=False, no_update=False, time_clip=False)

This function loads data from the Toroidal Imaging Mass Angle Spectrograph

Parameters:
  • trange (list of str) – time range of interest [starttime, endtime] with the format ‘YYYY-MM-DD’,’YYYY-MM-DD’] or to specify more or less than a day [‘YYYY-MM-DD/hh:mm:ss’,’YYYY-MM-DD/hh:mm:ss’]

  • datatype (str) – Data type; Valid options:

  • suffix (str) – The tplot variable names will be given this suffix. By default, no suffix is added.

  • get_support_data (bool) – Data with an attribute “VAR_TYPE” with a value of “support_data” will be loaded into tplot. By default, only loads in data with a “VAR_TYPE” attribute of “data”.

  • varformat (str) – The file variable formats to load into tplot. Wildcard character “*” is accepted. By default, all variables are loaded in.

  • varnames (list of str) – List of variable names to load (if not specified, all data variables are loaded)

  • downloadonly (bool) – Set this flag to download the CDF files, but not load them into tplot variables

  • notplot (bool) – Return the data in hash tables instead of creating tplot variables

  • no_update (bool) – If set, only load data from your local cache

  • time_clip (bool) – Time clip the variables to exactly the range specified in the trange keyword

Return type:

List of tplot variables created.

Example

import pyspedas
from pytplot import tplot
timas_vars = pyspedas.polar.timas(trange=['1997-01-03/6:00', '1997-01-03/7:00'], time_clip=True)
tplot(['Density_H', 'Density_O'])
_images/polar_timas.png

Charge and Mass Magnetospheric Ion Composition Experiment (CAMMICE)

pyspedas.polar.cammice(trange=['2003-10-28', '2003-10-29'], datatype='k0', suffix='', get_support_data=False, varformat=None, varnames=[], downloadonly=False, notplot=False, no_update=False, time_clip=False)

This function loads data from the Charge and Mass Magnetospheric Ion Composition Experiment

Parameters:
  • trange (list of str) – time range of interest [starttime, endtime] with the format ‘YYYY-MM-DD’,’YYYY-MM-DD’] or to specify more or less than a day [‘YYYY-MM-DD/hh:mm:ss’,’YYYY-MM-DD/hh:mm:ss’]

  • datatype (str) – Data type; Valid options:

  • suffix (str) – The tplot variable names will be given this suffix. By default, no suffix is added.

  • get_support_data (bool) – Data with an attribute “VAR_TYPE” with a value of “support_data” will be loaded into tplot. By default, only loads in data with a “VAR_TYPE” attribute of “data”.

  • varformat (str) – The file variable formats to load into tplot. Wildcard character “*” is accepted. By default, all variables are loaded in.

  • varnames (list of str) – List of variable names to load (if not specified, all data variables are loaded)

  • downloadonly (bool) – Set this flag to download the CDF files, but not load them into tplot variables

  • notplot (bool) – Return the data in hash tables instead of creating tplot variables

  • no_update (bool) – If set, only load data from your local cache

  • time_clip (bool) – Time clip the variables to exactly the range specified in the trange keyword

Return type:

List of tplot variables created.

Example

import pyspedas
from pytplot import tplot
cammice_vars = pyspedas.polar.cammice(trange=['2003-10-28', '2003-10-29'])
tplot('Protons')
_images/polar_cammice.png

Comprehensive Energetic Particle-Pitch Angle Distribution (CEPPAD)

pyspedas.polar.ceppad(trange=['2003-10-28', '2003-10-29'], datatype='k0', suffix='', get_support_data=False, varformat=None, varnames=[], downloadonly=False, notplot=False, no_update=False, time_clip=False)

This function loads data from the Comprehensive Energetic Particle-Pitch Angle Distribution

Parameters:
  • trange (list of str) – time range of interest [starttime, endtime] with the format ‘YYYY-MM-DD’,’YYYY-MM-DD’] or to specify more or less than a day [‘YYYY-MM-DD/hh:mm:ss’,’YYYY-MM-DD/hh:mm:ss’]

  • datatype (str) – Data type; Valid options:

  • suffix (str) – The tplot variable names will be given this suffix. By default, no suffix is added.

  • get_support_data (bool) – Data with an attribute “VAR_TYPE” with a value of “support_data” will be loaded into tplot. By default, only loads in data with a “VAR_TYPE” attribute of “data”.

  • varformat (str) – The file variable formats to load into tplot. Wildcard character “*” is accepted. By default, all variables are loaded in.

  • varnames (list of str) – List of variable names to load (if not specified, all data variables are loaded)

  • downloadonly (bool) – Set this flag to download the CDF files, but not load them into tplot variables

  • notplot (bool) – Return the data in hash tables instead of creating tplot variables

  • no_update (bool) – If set, only load data from your local cache

  • time_clip (bool) – Time clip the variables to exactly the range specified in the trange keyword

Return type:

List of tplot variables created.

Example

import pyspedas
from pytplot import tplot
cep_vars = pyspedas.polar.ceppad(trange=['2003-10-28', '2003-10-29'])
tplot(['IPS_10_ERR', 'IPS_30_ERR', 'IPS_50_ERR'])
_images/polar_ceppad.png

Orbit data

pyspedas.polar.orbit(trange=['2003-10-28', '2003-10-29'], datatype='k0', suffix='', get_support_data=False, varformat=None, varnames=[], downloadonly=False, notplot=False, no_update=False, time_clip=False)

This function loads Polar orbit data

Parameters:
  • trange (list of str) – time range of interest [starttime, endtime] with the format ‘YYYY-MM-DD’,’YYYY-MM-DD’] or to specify more or less than a day [‘YYYY-MM-DD/hh:mm:ss’,’YYYY-MM-DD/hh:mm:ss’]

  • datatype (str) – Data type; Valid options:

  • suffix (str) – The tplot variable names will be given this suffix. By default, no suffix is added.

  • get_support_data (bool) – Data with an attribute “VAR_TYPE” with a value of “support_data” will be loaded into tplot. By default, only loads in data with a “VAR_TYPE” attribute of “data”.

  • varformat (str) – The file variable formats to load into tplot. Wildcard character “*” is accepted. By default, all variables are loaded in.

  • varnames (list of str) – List of variable names to load (if not specified, all data variables are loaded)

  • downloadonly (bool) – Set this flag to download the CDF files, but not load them into tplot variables

  • notplot (bool) – Return the data in hash tables instead of creating tplot variables

  • no_update (bool) – If set, only load data from your local cache

  • time_clip (bool) – Time clip the variables to exactly the range specified in the trange keyword

Return type:

List of tplot variables created.

Example

import pyspedas
from pytplot import tplot
orb_vars = pyspedas.polar.orbit(trange=['2003-10-28', '2003-10-29'])
tplot(['SPIN_PHASE', 'AVG_SPIN_RATE'])
_images/polar_orbit.png