MCPcopy Index your code
hub / github.com/SuperDARN/pydarn

github.com/SuperDARN/pydarn @v4.3

Chat with this repo
repository ↗ · DeepWiki ↗ · release v4.3 ↗ · + Follow
235 symbols 733 edges 41 files 170 documented · 72%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

pydarn

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

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

Changelog

Version 4.3 - Minor Release!

This minor release includes: - Updated SciPy restriction and changes associated - NEW: True velocity in map plots - NEW: FITACF data detrending algorithm - Bug Fix: Updating HDW files on Windows 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.read_fitacf(fitacf_file)

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 publication. This notebook may be out of date.

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.

Core symbols most depended-on inside this repo

read_hdw_file
called by 47
pydarn/utils/superdarn_radars.py
time2datetime
called by 27
pydarn/utils/plotting.py
index_legendre
called by 8
pydarn/plotting/maps.py
plot_fov
called by 7
pydarn/plotting/fan.py
gate2geographic_location
called by 4
pydarn/utils/coordinates.py
great_circle
called by 4
pydarn/utils/general_utils.py
geod2geoc
called by 4
pydarn/utils/geo.py
plot_acf_param
called by 4
pydarn/plotting/acf.py

Shape

Method 113
Class 63
Function 59

Languages

Python100%

Modules by API surface

pydarn/utils/filters.py18 symbols
pydarn/exceptions/plot_exceptions.py18 symbols
test/test_RTP.py16 symbols
pydarn/plotting/maps.py15 symbols
test/test_utils.py14 symbols
pydarn/utils/terminator.py14 symbols
pydarn/utils/superdarn_radars.py12 symbols
pydarn/utils/geo.py11 symbols
pydarn/plotting/fan.py10 symbols
pydarn/plotting/rtp.py9 symbols
test/test_Fan.py7 symbols
pydarn/utils/range_estimations.py7 symbols

For agents

$ claude mcp add pydarn \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page