Commit 04067ea0 authored by Shreyas Bapat's avatar Shreyas Bapat

New upstream version 0.6.7

parents
deps-run: &deps-install
name: Install Python dependencies
command: |
python3 -m venv venv
. venv/bin/activate
pip install --user --quiet -r requirements/docs.txt
pip install --user .
doc-test: &doc-test
name: Run doctets
command: make doctest
working_directory: doc
doc-run: &doc-build
name: Build documentation
command: make html SPHINXOPTS='-W -q'
working_directory: doc
version: 2
jobs:
build:
docker:
- image: circleci/python:3.6
steps:
- checkout
- run: *deps-install
- run: *doc-test
- run: *doc-build
- store_artifacts:
path: doc/build/html
- run:
name: "Built documentation is available at:"
command: echo "${CIRCLE_BUILD_URL}/artifacts/${CIRCLE_NODE_INDEX}/${CIRCLE_WORKING_DIRECTORY/#\~/$HOME}/doc/build/html/index.html"
notify:
webhooks:
- url: https://giles.cadair.com/circleci
comment: off
ignore:
- "heliopy/_version.py"
[run]
omit = *__init__.py, *_test.py
heliopy/_version.py export-subst
*.pyc
.cache*
.coverage
.pytest_cache
doc/build*
doc/auto_examples
doc/source/auto_examples
doc/source/api
doc/source/gen_modules
heliopy.egg-info*
*.DS_Store*
build/*
dist/*
env
\ No newline at end of file
build:
image: latest
python:
version: 3.6
setup_py_install: true
requirements_file: requirements/docs.txt
sudo: false
language: python
cache: pip
matrix:
include:
- env: PYTHON_VERSION=3.6
- env: PYTHON_VERSION=3.7
- env: PYTHON_VERSION=3.7 PIPPRE=--pre
allow_failures:
- env: PYTHON_VERSION=3.7 PIPPRE=--pre
before_install:
- wget http://repo.continuum.io/miniconda/Miniconda-latest-Linux-x86_64.sh -O miniconda.sh
- chmod +x miniconda.sh
- "./miniconda.sh -b -p $HOME/miniconda"
- export PATH="$HOME/miniconda/bin:$PATH"
- conda update --yes conda
- conda create --yes -n testenv python=$PYTHON_VERSION
- source activate testenv
- conda install --yes hdf5
- pip install -r requirements/test.txt $PIPPRE
- export CLUSTERCOOKIE=2F1B4760251B51783700055F1A037271685A64680A1450722A465D302F0947606504526F370C40752A0640633228546C2A015F2F28075E
script:
- pytest heliopy/ --cov=heliopy/ -v --durations=5 --pep8
- python setup.py sdist
after_success:
- pip install codecov
- codecov
deploy:
provider: pypi
user: dstansby
password:
secure: dyxmaVJZsmBkESiiJiYjI/dAHLoe226TjHGR+GoPYwo7aIt6Be94NFM02Or4AD/6m1xVCR9nrc1vDl7zlgBLKnf48+7/jcf9FZ72CpfKajeLooiN4IagkmandF22FbEtYqHmvL/EYrSiPoxQYOPH6zKBwLzpdKQyk65ou0UwwMztRq5FG1KU/cel7D6aIs8kpZrFWZtk3tryoFQlD5w4NSERl1FR2/2b+acB3TSFOiDA6fp0l+F/sOTgoouk2DEaAHp0pSGh9EmFWsJflvLRisUcfPro17/aTv6UvZGD4QOScC+OI8h3GZqIRy1ELekFK1t2jv4DV+7DZ5oMJGpMKcC/6qpB8WUm02q2tSchT5VwX/fez14M1jb1rlbqHPvsKe8oQdhoGoayr66zji9BEd/sjFq7i1p0XpQZLnOoyKsQrtv3hbqPYgZres4Z51T9oKZLk2LGWb9kMbCWNDYdit9SpV5SVQTLcdx2oG6r3rLgK8BDliA+qKKPjmIHQWRh8yIcz/ZZ7F7D+X/ubfxZBRoQbqarjAF31Rdyma69++7LZnTBpQSA/mWgiWN4qXgrpY9alg66tD8TKPuPPf2g9Tq38iF/MyxOVWtEEz2ztRdPlYVh8n0WkFWn46Gm2ZYTH0YrR90VqKK1dsZwoQWPeL5h2s0cAQ/TSVrX9cCWSS4=
on:
tags: true
distributions: sdist
Version 0.6.7
-------------
- :func:`heliopy.data.wind.swe_h3` and :func:`heliopy.data.wind.threedp_sfpd`
are deprecated and will be removed in version 0.7.0. This is becaue they
currently use pandas MultiIndex structures, which are not the recommended
way to store 2-or-more dimensional data. In the future they are likely to be
re-written to use xarray.
Version 0.6.6
-------------
Bug fixes
^^^^^^^^^
- Data downloaded through CDAS is now moved from a temporary folder using
``shutil``, fixing it when the temp folder and destination folder are on
different filesystems.
Version 0.6.5
-------------
Bug fixes
^^^^^^^^^
- :func:`heliopy.data.spice.get_kernel` now raises a warning instead of an
error if a kernel can't be downloaded.
- :func:`heliopy.data.helios.merged` now filters out bad values and converts
them to NaNs.
- :mod:`heliopy.spice` now only loads core SPICE kernels once, instead of every
time the module is imported.
Backwards incompatible changes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
- :func:`heliopy.data.spice.get_kernel` now prints a warning instead of
raising an error if a kernel cannot be downloaded.
Version 0.6.4
-------------
New features
^^^^^^^^^^^^
- Added the ability for :class:`heliopy.spice.Trajectory` objects to compute
and return the body velocity.
- Available spice kernels in :mod:`heliopy.data.spice` are now split into
kernels that have been reconstructed (ie. actual trajectories) and
predicted trajectories.
- The predicted Bepi Columbo spice kernel has been added to
:mod:`heliopy.data.spice`
- The :func:`heliopy.data.ace.swi_h3b` function has been added.
- :func:`heliopy.data.cdasrest.get_variables` and
:func:`heliopy.data.cdasrest.get_data` now have a ``timeout`` keyword
argument, allowing manual specification of the timeout when fetching data
from a server.
- Importing :mod:`heliopy.spice` now automatically loads common heliospheric
coordinate systems.
Backwards incompatible changes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
- Kernels available in :mod:`heliopy.data.spice` have been cleaned up,
meaning some are now not available or have been moved to the predicted
section.
- A handful of data download functions have migrated to using the CDAS restful
service, and have therefore had their call signatures changed. In particular:
- :func:`heliopy.data.messenger.mag_rtn` has lost its ``try_download`` kwarg
- :func:`heliopy.data.helios.merged` has lost its ``try_download`` kwarg
The following IMP download functions, which only ever worked for IMP8 have
been renamed:
- `mitplasma_h0` has been renamed :func:`~heliopy.data.imp.i8_mitplasma`
- `mag320ms` has been renamed :func:`~heliopy.data.imp.i8_mag320ms`
Version 0.6.3
-------------
New features
^^^^^^^^^^^^
- Added Parker Solar Probe spice kernels to :mod:`heliopy.data.spice`.
- Added a generic functions to download MMS data. Available files can be
queried using :meth:`heliopy.data.mms.available_files`, and files can be
downloaded using :meth:`heliopy.data.mms.download_files`
Bug fixes
^^^^^^^^^
- Updated links to the STEREO-A spice kernels.
Backwards incompatible changes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
- :meth:`heliopy.data.mms.fgm_survey` has been removed in favour of the more
general :meth:`heliopy.data.mms.fgm`. To download survey mode FGM data use
the new method and set the ``mode`` keyword argument to ``srvy``.
Version 0.6.2
-------------
New features
^^^^^^^^^^^^
- Added :meth:`heliopy.data.mms.fpi_des_moms` function. :issue:`601`
- Added :meth:`heliopy.data.wind.threedp_e0_emfits` function. :issue:`606`
Bug fixes
^^^^^^^^^
- Fixed :meth:`heliopy.data.mms.fgm_survey` data loading. :issue:`601`
Version 0.6.1
-------------
New features
^^^^^^^^^^^^
- The :mod:`heliopy.data.ace` module now contains all the magnetic field and
particle data produces produced by ACE. :issue:`577`, :issue:`578`
- STEREO-A spice kernels have been added. :issue:`585`
Bug fixes
^^^^^^^^^
- The accidentally removed Ulysses spice kernel has returned. :issue:`582`
- :func:`heliopy.data.helper.cdfpeek` has been updated to work with cdflib, and now
prints all CDF file information.
Version 0.6.0
-------------
HelioPy now only supports Python versions 3.6 and higher.
New features
^^^^^^^^^^^^
- HelioPy has been integrated with SunPy TimeSeries and AstroPy Units. All of
the HelioPy modules now return physical units with data.
- Added a new :func:`.data.util.cdf_units` function that can extract the UNIT
attribute from CDF files.
- Low resolution OMNI data import has been added in
:func:`.data.omni.low` function.
- Magnetic Field data from DSCOVR Spacecraft
can now be imported using the :func:`.data.dscovr.mag_h0` function.
Backwards incompatible changes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
- Methods in :mod:`heliopy.data` no longer returns a Pandas DataFrame, but
now return a SunPy timeseries object. To get the underlying data, you can
still do::
dataframe = timeseries.data
For an example of how to use the new object, see
:ref:`sphx_glr_auto_examples_plot_timeseries.py`.
- Data import has had a major overhaul, so that every column in CDF files now
gets automatically imported and retains its name without being changed by
HelioPy. This means column names in several data products are now different,
to reflect their original name in the CDF files instead of a custom name
that was previously assigned by HelioPy.
- :func:`.data.helios.merged`, :func:`.data.helios.mag_4hz`,
:func:`.data.helios.corefit` and :func:`.data.helios.mag_ness` no longer take
a `verbose` keyword argument. :issue:`467`
Fixed bugs
^^^^^^^^^^
- :func:`.data.imp.merged` no longer imports redundant columns.
Version 0.5.3
-------------
New features
^^^^^^^^^^^^
- Lots of small documentation updates.
- `.data.helios.distparams` now has an extra ``'data_rate'`` column, which
determines whether a given distribution function was transmitted in high or
low data mode. :issue:`529`
Version 0.5.2
-------------
New features
^^^^^^^^^^^^
- The new HelioPy logo has been added to the documentation.
:issue:`448`, :issue:`447`
Fixed bugs
^^^^^^^^^^
- The new data version number of :meth:`.data.mms.fpi_dis_moms` has been
updated.
Version 0.5.1
-------------
New features
^^^^^^^^^^^^
- HelioPy can now be installed using conda.
Backwards incompatible changes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
- The list of kernels available for automatic download in :mod:`.data.spice`
has been updated, and some names changed. :issue:`408`
Fixed bugs
^^^^^^^^^^
- :meth:`.spice.Trajectory.generate_positions` can now generate
positions at a resolution of one second instead of one day. :issue:`405`
- A duplicate "z gsm" column header in the data returned by
:meth:`.data.imp.mag15s` has been corrected. :issue:`396`
Version 0.5.0
-------------
New features
^^^^^^^^^^^^
- :meth:`heliopy.data.sunspot` added an additional functionality to import
sunspot data in three different timeframes - daily, monthly and yearly.
- The inventory of spice kernels in :mod:`heliopy.data.spice` now includes
"Helios 1 Reconstructed", "Helios 1 Predicted", "Juno Reconstructed",
"Juno Predicted" and "Helios 2" kernels.
- :meth:`heliopy.spice.furnish` now accepts a list of filenames as well as
individual filenames.
- A lot of new functions for downloading ACE data have been added to
:mod:`heliopy.data.ace`.
Backwards incompatible changes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
- :meth:`heliopy.data.spice.get_kernel` now returns a list of filenames instead
of a single filename string.
- Most of the functions that were in :mod:`heliopy.data.helper` have been
moved to :mod:`heliopy.data.util`. The ones the remain in
:mod:`heliopy.data.helper` are useful for users, and the ones in
:mod:`heliopy.data.util` are used internally as utility functions for
data import.
Removed features
^^^^^^^^^^^^^^^^
- :meth:`heliopy.data.helios.trajectory` has been removed. To get Helios
trajectory data use the :mod:`heliopy.spice` and :mod:`heliopy.data.spice`
modules.
Version 0.4
-----------
New features
^^^^^^^^^^^^
- :meth:`~heliopy.data.ulysses.swics_abundances` and
:meth:`~heliopy.data.ulysses.swics_heavy_ions`
methods added for loading SWICS data from the Ulysses mission.
- :meth:`~heliopy.data.helper.cdfpeek` method added for peeking inside
CDF files.
Backwards incompatible changes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
- :meth:`heliopy.spice.Trajectory.generate_positions` now takes a list of
dates/times at which to generate orbital positions, instead of a start time,
stop time, and number of steps. The old behaviour can be recovered by
manually generating an evenly spaced list of times.
Version 0.3
-----------
New features
^^^^^^^^^^^^
HelioPy now contiains code for working with SPICE kernels. See the following
modules for more information:
- :mod:`heliopy.data.spice` module for downloading spice kernels
- :mod:`heliopy.spice` module for automatically processing spice kernels
Removed features
^^^^^^^^^^^^^^^^
- The :mod:`heliopy.plasma` module has been removed
(see http://www.plasmapy.org/ for the recommended alternative)
- :mod:`heliopy.plot` code removed
Version 0.2
-----------
New features
^^^^^^^^^^^^
- Convert examples gallery to automatically generate plots
- Added :meth:`HelioPy.data.helper.listdata` method for easily viewing the
amount of data HelioPy is storing locally.
- Added :meth:`heliopy.data.wind.threedp_sfpd` method for importing
WIND 3DP sfpd data.
Version 0.1.3
-------------
Fixed bugs
^^^^^^^^^^
- Correctly report download percentage when downloading files.
- Fix issue where :meth:`heliopy.data.helios.corefit` made duplicate .hdf
files on days where no data is available.
HelioPy community Code of Conduct
---------------------------------
The community of participants in open source projects, including HelioPy,
is made up of members from around the globe with a diverse set of
skills, personalities, and experiences. It is through these differences that
our community experiences success and continued growth. We expect everyone
in our community to follow these guidelines when interacting with others both
inside and outside of our community. Our goal is to keep ours a positive,
inclusive, successful, and growing community.
As members of the community:
- We pledge to treat all people with respect and provide a harassment-
and bullying-free environment, regardless of sex, sexual orientation
and/or gender identity, disability, physical appearance, body size,
race, nationality, ethnicity, and religion.
In particular, sexual language and imagery, sexist, racist,
or otherwise exclusionary jokes are not appropriate.
- We pledge to respect the work of others by recognising
acknowledgment/citation requests of original authors.
As authors, we pledge to be explicit about how we want our own work
to be cited or acknowledged.
- We pledge to welcome those interested in joining the community,
and realise that including people with a variety of opinions and
backgrounds will only serve to enrich our community. In particular,
discussions relating to pros/cons of various technologies,
programming languages, and so on are welcome,
but these should be done with respect, taking proactive measure to
ensure that all participants are heard and feel confident that they
can freely express their opinions.
- We pledge to welcome questions and answer them respectfully,
paying particular attention to those new to the community.
We pledge to provide respectful criticisms and feedback in forums,
especially in discussion threads resulting from code contributions.
- We pledge to be conscientious of the perceptions of the wider community
and to respond to criticism respectfully. We will strive to mode
behaviours that encourage productive debate and disagreement, both
within our community and where we are criticised.
We will treat those outside our community with the same respect
as people within our community.
- We pledge to help the entire community follow the code of conduct,
and to not remain silent when we see violations of the code of conduct.
This code of conduct applies to all community situations online and offline,
including mailing lists, forums, social media, conferences, meetings,
associated social events, and one-to-one interactions.
This code of conduct has been adapted from the astropy code of conduct, which
in turn was partly adapted from the PSF code of conduct.
Metadata-Version: 2.1
Name: HelioPy
Version: 0.6.7
Summary: Python for space physics
Home-page: http://heliopy.org/
Author: David Stansby
Author-email: dstansby@gmail.com
License: GPL-3.0
Description: UNKNOWN
Keywords: physics,space-physics
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.6
Provides-Extra: spice
Provides-Extra: data
Provides-Extra: coordinates
.codecov.yml
.coveragerc
.gitattributes
.gitignore
.readthedocs.yml
.travis.yml
CHANGES.rst
CODE_OF_CONDUCT.rst
LICENSE
MANIFEST.in
README.md
appveyor.yml
codecov.yml
setup.cfg
setup.py
versioneer.py
.circleci/config.yml
HelioPy.egg-info/PKG-INFO
HelioPy.egg-info/SOURCES.txt
HelioPy.egg-info/dependency_links.txt
HelioPy.egg-info/requires.txt
HelioPy.egg-info/top_level.txt
artwork/favicon.ico
artwork/logo_circle.png
artwork/logo_circle.svg
artwork/logo_rectangle.png
artwork/logo_rectangle.svg
doc/Makefile
doc/heliopy_theme/LICENSE.md
doc/heliopy_theme/docsidebar.html
doc/heliopy_theme/layout.html
doc/heliopy_theme/navbar.html
doc/heliopy_theme/theme.conf
doc/heliopy_theme/static/copybutton.js
doc/heliopy_theme/static/navbar.svg
doc/heliopy_theme/static/style.css
doc/heliopy_theme/static/version.js
doc/source/conf.py
doc/source/coords.rst
doc/source/index.rst
doc/source/spice.rst
doc/source/data/ace.rst
doc/source/data/artemis.rst
doc/source/data/cassini.rst
doc/source/data/cdas.rst
doc/source/data/cluster.rst
doc/source/data/dscovr.rst
doc/source/data/helios.rst
doc/source/data/helper.rst
doc/source/data/imp.rst
doc/source/data/index.rst
doc/source/data/messenger.rst
doc/source/data/mms.rst
doc/source/data/omni.rst
doc/source/data/spice.rst
doc/source/data/sunspot.rst
doc/source/data/ulysses.rst
doc/source/data/util.rst
doc/source/data/wind.rst
doc/source/development/contributing.rst
doc/source/development/docs.rst
doc/source/development/index.rst
doc/source/development/minor_releases.rst
doc/source/development/release.rst
doc/source/development/testing.rst
doc/source/guide/citing.rst
doc/source/guide/code-of-conduct.rst
doc/source/guide/configuring.rst
doc/source/guide/index.rst
doc/source/guide/installing.rst
doc/source/guide/logo.rst
doc/source/guide/whatsnew.rst
examples/README.txt
examples/data_inventory.py
examples/fast_file_loading.py
examples/plot_importing_data.py
examples/plot_omni.py
examples/plot_spice_orbit.py
examples/plot_sunspot.py
examples/plot_timeseries.py
examples/timeseries.py
examples/data/helios/helios2/plasma/1976/h2_1976_096_corefit.csv
heliopy/__init__.py
heliopy/_version.py
heliopy/heliopyrc
heliopy/spice.py
heliopy/coordinates/__init__.py
heliopy/coordinates/frames.py
heliopy/coordinates/test/__init__.py
heliopy/coordinates/test/test_transformations.py
heliopy/data/__init__.py
heliopy/data/ace.py
heliopy/data/artemis.py
heliopy/data/cassini.py
heliopy/data/cdasrest.py
heliopy/data/cluster.py
heliopy/data/dscovr.py
heliopy/data/helios.py
heliopy/data/helper.py
heliopy/data/imp.py
heliopy/data/messenger.py
heliopy/data/mms.py
heliopy/data/omni.py
heliopy/data/spice.py
heliopy/data/sunspot.py
heliopy/data/ulysses.py
heliopy/data/util.py
heliopy/data/wind.py
heliopy/data/test/__init__.py
heliopy/data/test/test_data.py
heliopy/test/__init__.py
heliopy/test/test_spice.py
heliopy/util/__init__.py
heliopy/util/config.py
requirements/base.txt
requirements/docs.txt
requirements/extras.txt
requirements/test.txt
\ No newline at end of file
numpy
astropy
[coordinates]
sunpy
[data]
pandas
sunpy
requests
cdflib
wget
[spice]
spiceypy
This diff is collapsed.
include heliopy/heliopyrc
include LICENSE
include versioneer.py
include heliopy/_version.py
Metadata-Version: 2.1
Name: HelioPy
Version: 0.6.7
Summary: Python for space physics
Home-page: http://heliopy.org/
Author: David Stansby
Author-email: dstansby@gmail.com
License: GPL-3.0
Description: UNKNOWN
Keywords: physics,space-physics
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.6
Provides-Extra: spice
Provides-Extra: data
Provides-Extra: coordinates
![HelioPy](https://github.com/heliopython/heliopy/raw/master/artwork/logo_rectangle.png "HelioPy")
A python library for heliospheric and planetary Physics.
The primary goal of HelioPy is to provide a set of tools to download and read
in data, and to carry out other common data processing tasks.
Full documentation can be found [here](http://docs.heliopy.org/).
A quick example shows how easy it is to import and view data:
```python
from datetime import datetime, timedelta
import heliopy.data.wind as wind
import matplotlib.pyplot as plt
starttime = datetime(2016, 1, 1, 0, 0, 0)
endtime = starttime + timedelta(hours=2)
data = wind.mfi_h0(starttime, endtime)
plt.plot(data['Bx_gse'])
plt.plot(data['By_gse'])
plt.plot(data['Bz_gse'])
plt.show()
```
**If HelioPy is missing a method to import a dataset you are interested in,
please submit a request at https://github.com/heliopython/heliopy/issues.**
[![Build Status](https://travis-ci.org/heliopython/heliopy.svg?branch=master)](https://travis-ci.org/heliopython/heliopy)
[![Coverage](https://codecov.io/gh/heliopython/heliopy/branch/master/graph/badge.svg)](https://codecov.io/gh/heliopython/heliopy)
environment:
global:
PYTHON: "C:\\conda"
MINICONDA_VERSION: "latest"
# SDK v7.0 MSVC Express 2008's SetEnv.cmd script will fail if the
# /E:ON and /V:ON options are not enabled in the batch script intepreter
# See: http://stackoverflow.com/a/13751649/163740
CMD_IN_ENV: "cmd /E:ON /V:ON /C .\\ci-helpers\\appveyor\\windows_sdk.cmd"
NUMPY_VERSION: "stable"
matrix:
- PYTHON_VERSION: "3.7"
matrix:
fast_finish: true
platform:
- x64
install:
# Install miniconda using astropy helper
- "git clone git://github.com/astropy/ci-helpers.git"
- "powershell ci-helpers/appveyor/install-miniconda.ps1"
- "SET PATH=%PYTHON%;%PYTHON%\\Scripts;%PATH%"
- "activate test"
- cmd: conda install --yes hdf5
- "pip install -r requirements/test.txt"
# Not a .NET project, we build heliopy in the install step instead
build: false
test_script: