Skip to content

Conversation

@mgharamti
Copy link
Contributor

@mgharamti mgharamti commented Oct 29, 2025

Description:

Added a new observation converter that allows for assimilation of ocean currents. It supports total U and V vector components in addition to radial ones. The radial ones make use of a slightly modified radial FO operator. The PR also includes a detailed documentation of the converter.

This effort is part of the Baron collaboration on the InaCAWO project.

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update

Documentation changes needed?

  • My change requires a change to the documentation.
    • I have updated the documentation accordingly.

Tests

I have run the converter extensively using single and multi raw obs files. I also used different observation types (radials vs totals) to validate the functionality. I also ran filter using the resulting obs_seq file (~7000 obs) and assessed teh results. I included a figure from a filter run in the documentation of the converter.

Checklist for merging

  • Updated changelog entry
  • Documentation updated
  • Update conf.py

Checklist for release

  • Merge into main
  • Create release from the main branch with appropriate tag
  • Delete feature-branch

Testing Datasets

Dataset can be accessed here: /glade/derecho/scratch/gharamti/inacawo/DART/observations/obs_converters/HFradar/data

Added and tested functionality of the HF radar converter
- It allows the assimilation of U, V, and radial components
- Radial components make use of the radial FO in obs_def_ocean
- The radial velocities add instrument ID and angle in the obs_seq file
- The FO operator is updated to allow for zero bearing angle from the instrument
Also added links in the toctree
Allows observations to be added in different time order.
Comment on lines 354 to 356
.. tip::
* When converting many files, prefer ``file_list`` for clearer logging and
correct pre-allocation.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is mentioned in #991 also and I am a little confused about the intent. A couple of questions come up: Why give people the option of a single file vs. a list? Is the pre-allocation incorrect with a single file?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good question. I also debated that. I ended up giving both single and list options mainly for 2 reasons:

  • to be consistent with other obs_converters and the obs programs in DART
  • for training/testing purposes (upcoming in April next year), people would be interested in looking at the functionality using a single obs file that perhaps has 1 timestamp in it.
    Perhaps, I can update that tip for clarity.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cleaned some of the docs and removed unnecessary statements

@hkershaw-brown hkershaw-brown added the release! bundle with next release label Nov 11, 2025
Copy link
Contributor

@mjs2369 mjs2369 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ready to merge, nice work Moha!

@hkershaw-brown hkershaw-brown merged commit 482d18b into NCAR:main Nov 13, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

release! bundle with next release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants