Skip to main content

Data visualization library for SuperDARN data

Project description

pydarn

License: LGPL v3 Python 3.6 GitHub release (latest by date) DOI

Python data visualization library for the Super Dual Auroral Radar Network (SuperDARN).

Changelog

Version 4.1 - Minor Release!

This minor release includes:

  • NEW MAG projection
  • NEW 'Zooming-in' on GEO and MAG projections
  • NEW NSSC Radars Included
  • NEW Calculation of Potential at Lat/Lon Position from Map Files
  • NEW Map Potential Time-Series Plots at Lat/Lon Position
  • NEW User Input Fan Plots
  • Cartopy now a full dependency
  • Updates to fan plots for usability including scan_time and scan_time_tolerance keywords
  • Embargo warning for -CPID data that is less than a year old
  • Coordinates converted to magnetic coordinates more efficiently
  • Bug fix Map plots lowlat default discrepancy fixed

Documentation

pyDARN's documentation can be found here

Getting Started

pip install pydarn

Or read the installation guide.

If wish to get access to SuperDARN data please read the SuperDARN data access documentation. Please make sure to also read the documentation on citing superDARN and pydarn.

As a quick tutorial on using pydarn to read a non-compressed file:

import matplotlib.pyplot as plt

import pydarn

# read a non-compressed file
fitacf_file = '20190831.C0.cly.fitacf'

# pyDARN functions to read a fitacf file
fitacf_data = pydarn.SuperDARNRead(fitacf_file).read_fitacf()

pydarn.RTP.plot_summary(fitacf_data, beam_num=2)
plt.show()

summary plot

For more information and tutorials on pyDARN please see the tutorial section.

We also have a Jupyter notebook with many examples to support our recent publication.

Getting involved

pyDARN is always looking for testers and developers keen on learning python, github, and/or SuperDARN data visualizations! Here are some ways to get started:

  • Testing Pull Request: to determine which pull requests need to be tested right away, filter them by their milestones (v3.0 is currently highest priority).
  • Getting involved in projects: if you are looking to help in a specific area, look at pyDARN's projects tab. The project you are interested in will give you information on what is needed to reach completion. This includes things currently in progress, and those awaiting reviews.
  • Answer questions: if you want to try your hand at answering some pyDARN questions, or adding to the discussion, look at pyDARN's issues and filter by labels.
  • Become a developer: if you want to practice those coding skills and add to the library, look at pyDARN issues and filter by milestone's to see what needs to get done right away.

Please read pyDARN team on how to join the pyDARN team.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pydarn-4.1.tar.gz (114.9 kB view details)

Uploaded Source

Built Distribution

pydarn-4.1-py3-none-any.whl (144.8 kB view details)

Uploaded Python 3

File details

Details for the file pydarn-4.1.tar.gz.

File metadata

  • Download URL: pydarn-4.1.tar.gz
  • Upload date:
  • Size: 114.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.13

File hashes

Hashes for pydarn-4.1.tar.gz
Algorithm Hash digest
SHA256 22de1857d0e0bb045e2a8be6f56b6d04d4d48102fd3875f74bff4a622389798a
MD5 cab3557f2fca19a7f0273aca1f88c632
BLAKE2b-256 37003bedcbf8bc55d37cf6500af1f9d96ab775164111a57d1fb99c23d17dc907

See more details on using hashes here.

File details

Details for the file pydarn-4.1-py3-none-any.whl.

File metadata

  • Download URL: pydarn-4.1-py3-none-any.whl
  • Upload date:
  • Size: 144.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.13

File hashes

Hashes for pydarn-4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f96f6ee1360ada2ddc403773179820e27bd140b4f37870e7286d0d24dccadf9c
MD5 a45b6553524b48a2696ee035c2205a4a
BLAKE2b-256 aa98724477268763ef4ef3d620b174f692dfa99a520882e627009660ef88c76d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page