Skip to content

Basic conversion operators for humidity, temperature and pressure #1865

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Draft
daflack wants to merge 49 commits into
base: main
Choose a base branch
from
Draft

Basic conversion operators for humidity, temperature and pressure #1865

daflack wants to merge 49 commits into from

Conversation

@daflack
Copy link
Contributor

@daflack daflack commented Jan 2, 2026

Creates a series of basic conversion operators, not worrying about grid staggering or vertical levels at this point. The humidity, pressure, and temperature are all treated together due to the fact that they are strongly linked to each other and require the mix of code to be calculated.

Fixes #1852.

Contribution checklist

Aim to have all relevant checks ticked off before merging. See the developer's guide for more detail.

  • Documentation has been updated to reflect change.
  • New code has tests, and affected old tests have been updated.
  • All tests and CI checks pass.
  • Ensured the pull request title is descriptive.
  • Conda lock files have been updated if dependencies have changed.
  • Attributed any Generative AI, such as GitHub Copilot, used in this PR.
  • Marked the PR as ready to review.

@daflack daflack self-assigned this Jan 2, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Jan 2, 2026 •
edited
Loading

Coverage

@daflack
Copy link
Contributor Author

daflack commented Jan 2, 2026 •
edited
Loading

Conversions required, once basic code is done (excluding tests and full documentation will tick off)

A set of conversion operators for different humidity variables to be stored under humidity.py:

  • specific humidity to mixing ratio
  • mixing ratio to specific humidity
  • specific humidity to relative humidity
  • mixing ratio to relative humidity
  • relative humidity to specific humidity
  • relative humidity to mixing ratio

A set of derived temperature operators in 'temperature.py':

  • Virtual temperature
  • Dewpoint temperature
  • Wet-bulb temperature
  • Potential temperature
  • Equivalent potential temperature
  • Virtual potential temperature
  • Saturation potential temperature
  • Wet-bulb potential temperature

A set of derived pressure operators in 'pressure.py':

  • Vapour pressure
  • Vapour pressure from RH
  • Exner pressure

@daflack daflack force-pushed the 1852_conversion_operators branch 2 times, most recently from 5be21d9 to e917bd6 Compare January 5, 2026 13:43
@daflack
Copy link
Contributor Author

daflack commented Jan 5, 2026 •
edited
Loading

Once full documentation done, will tick off.

A set of conversion operators for different humidity variables to be stored under humidity.py:

  • specific humidity to mixing ratio
  • mixing ratio to specific humidity
  • specific humidity to relative humidity
  • mixing ratio to relative humidity
  • relative humidity to specific humidity
  • relative humidity to mixing ratio

A set of derived temperature operators in 'temperature.py':

  • Virtual temperature
  • Dewpoint temperature
  • Wet-bulb temperature
  • Potential temperature
  • Equivalent potential temperature
  • Virtual potential temperature
  • Saturation potential temperature
  • Wet-bulb potential temperature

A set of derived pressure operators in 'pressure.py':

  • Vapour pressure
  • Vapour pressure from RH
  • Exner pressure

@daflack
Copy link
Contributor Author

daflack commented Jan 5, 2026 •
edited
Loading

Once tests done, will tick off.

A set of conversion operators for different humidity variables to be stored under humidity.py:

  • specific humidity to mixing ratio
  • mixing ratio to specific humidity
  • specific humidity to relative humidity
  • mixing ratio to relative humidity
  • relative humidity to specific humidity
  • relative humidity to mixing ratio

A set of derived temperature operators in 'temperature.py':

  • Virtual temperature
  • Dewpoint temperature
  • Wet-bulb temperature
  • Potential temperature
  • Equivalent potential temperature
  • Virtual potential temperature
  • Saturation potential temperature
  • Wet-bulb potential temperature

A set of derived pressure operators in 'pressure.py':

  • Vapour pressure
  • Vapour pressure from RH
  • Exner pressure

@daflack daflack force-pushed the 1852_conversion_operators branch from 13c9d93 to 45e8bcd Compare January 6, 2026 09:43
daflack added 22 commits January 7, 2026 16:01
@daflack
Basic conversion operators for humidity, temperature and pressure
8195c5c 
Fixes #1852
@daflack
Add mixing ratio to specific humidity operator
24329ce
@daflack
Add standard atmospheric constants
1bed18f
@daflack
Add vapour pressure conversion
6ddd18f
@daflack
Add vapour pressure if dewpoint unknown
afd8447
@daflack
Update naming convections for vapour pressures
121f46e
@daflack
Calculate saturation mixing ratio and specific humidity
e042a62
@daflack
Rename vapour_pressure_if_dewpoint_unknown to vapour_pressure_from_RH
fdebe14
@daflack
Add mixing ratio from relative humidity conversion
118affc
@daflack
Add specific humidity from RH conversion
5250de4
@daflack
Add relative humidity conversions from mixing ratio and specific
bdf29a9 
humidity
@daflack
Add dewpoint temperature calculation
007a759
@daflack
Add virtual temperature calculation
941322e
@daflack
Update atmospheric constants with kappa
0cd8995
@daflack
Add potential temperature and exner pressure convertors
8779ae3
@daflack
Adds virtual potential temperature convertor
5c6f4ba
@daflack
Adds equivalent potential temperature conversion and fixes unit assig…
7e5c208 
…nment
@daflack
Remove if loop for RH and switch to convert units
c725bd3
@daflack
Adds wet-bulb temperature convertor
317d639
@daflack
Adds relevant references for temperature calculations where required
366455e
@daflack
Adds wet-bulb potential temperature convertor
942195e
@daflack
Adds saturation equivalent potential temperature convertor
dd8600a
daflack added 18 commits January 7, 2026 16:01
@daflack
Adds to init file and updates name for atmospheric constants
72bab9f
@daflack
Update argument names in specific humidity to mixing ratio and vice
c382b3e 
versa
@daflack
Uses convert_units for pressure consistency
b8bac07
@daflack
Adds names to humidity cubes where missing
b101562
@daflack
Correct units
b8ef61b
@daflack
Adds tests data and fixtures
d51b5c2
@daflack
Update copyright year
e5d1de9
@daflack
Add tests for vapour pressure
94a279b
@daflack
Update to assignment in pressure convertors
7c93b3a
@daflack
Rename vapour_pressure_from_RH to relative_humidity_to_vapour_pressure
16fa2b9
@daflack
Adds tests for relative_humidity_to_vapour_pressure
975b426
@daflack
Adds tests for exner pressure
5523a45
@daflack
Uses atmospheric constants in tests
f7b728a
@daflack
Change to vapour pressure from relative humidity as more intuitive
e1a11d7
@daflack
Update aming convention to be x_from_y rather than y_from_x
60e58fb
@daflack
Update operators in temperature for correct conversion name
05eb6bc
@daflack
Adds test data and fixtures for humidity convertors
fabc933
@daflack
Adds tests for specific humidity and mixing ratio conversions
667889d
@daflack daflack force-pushed the 1852_conversion_operators branch from dde531a to 667889d Compare January 7, 2026 16:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

@daflack daflack

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Basic conversion operators

2 participants

@daflack