Skip to content

Cleaning up the documentation with proofreading and a more detailed user's guide.#151

Merged
rcjackson merged 4 commits intoopenradar:mainfrom
rcjackson:updated_docs
Mar 5, 2026
Merged

Cleaning up the documentation with proofreading and a more detailed user's guide.#151
rcjackson merged 4 commits intoopenradar:mainfrom
rcjackson:updated_docs

Conversation

@rcjackson
Copy link
Collaborator

I am providing edits to the documentation, fixing numerous spelling and grammar errors. There is also more information about PyDDA's wind retrieval in the user guide as well as documentation on the one-way nested retrievals.

Robert Jackson and others added 4 commits February 24, 2026 14:29
This release includes critical fixes to the smoothness cost and gradient functions
that were causing inconsistent behavior between JAX and NumPy/SciPy engines.

Key changes in this release:
- Fixed incorrect axis parameters in smoothness second derivative calculations
- Removed duplicate Cx, Cy, Cz coefficient scaling in gradient functions
- Simplified JAX gradient function to use automatic differentiation exclusively

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Fix typos throughout README, ROADMAP, user guide, and contributor guide
- Replace defunct Travis CI badge with GitHub Actions badge
- Replace deprecated `python setup.py install` with `pip install -e .`
- Fix broken/incorrect URLs (Discourse link, Contributor Covenant, test file)
- Align minimum Python version to 3.9 consistently
- Replace discontinued ERA Interim reference with ERA5
- Remove stray merge-conflict `=======` separators from README
- Fix duplicate toctree entries and add missing nesting_wind_retrieval.rst stub
- Expand empty overview.rst and visualizing_winds.rst with real content
- Correct radar description (X-SAPR → NEXRAD KTLX/KICT) in user guide
- Fix duplicate J_o cost function label in retrieving_winds.rst
- Add pydda.io module to dev reference index; fix "initalization" typo there
- Fix docstring errors: v_back description, max_bca direction, max_wind_mag name,
  initial guess typos, and capability spelling in wind_retrieve.py
- Fix "jax inport" comment typo in cost_functions.py

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Corrected a typo in the recommendation for optimizing the wind retrieval process.
@rcjackson rcjackson merged commit d5a7372 into openradar:main Mar 5, 2026
14 checks passed
@codecov
Copy link

codecov bot commented Mar 5, 2026

Codecov Report

❌ Patch coverage is 50.00000% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 68.85%. Comparing base (f7c7d3f) to head (b928377).
⚠️ Report is 6 commits behind head on main.

Files with missing lines Patch % Lines
setup.py 0.00% 1 Missing ⚠️
Additional details and impacted files
@@           Coverage Diff           @@
##             main     #151   +/-   ##
=======================================
  Coverage   68.85%   68.85%           
=======================================
  Files          32       32           
  Lines        5141     5141           
=======================================
  Hits         3540     3540           
  Misses       1601     1601           
Flag Coverage Δ
unittests 68.85% <50.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant