AusClimateService / AusClimateService/npcp

AGCD/AWRA time alignment

Open
#27 0 comments 1 reaction 0 assignees View on GitHub
Dominant language
Jupyter Notebook
Stars
2
Forks
5
PR merge metrics
No merged PRs in 30d

Description

From the AWRA v7 [technical report](https://awo.bom.gov.au/assets/notes/publications/AWRA-Lv7_Model_Description_Report.pdf) (page 9):

The following notation is used for the climate forcing in the AWRA report:
- 𝑃𝑔 Daily gross precipitation to 9am local time (mm)
- 𝐾𝑑 Daily downwelling shortwave (solar) radiation midnight to midnight (MJ m–2 d–1),
- 𝑒2 Wind speed at a height of 2 m to 9am (m/s)
- 𝑝𝑒 Actual vapour pressure (Pa)
- π‘‡π‘šπ‘–π‘› Daily minimum air temperature to 9am local time (Β°C), and
- π‘‡π‘šπ‘Žπ‘₯ Daily maximum air temperature from 9am local time (Β°C)

AWRA-L calculates the water balance between 9 am of the day before to 9 am of its timestamp, predominantly to align with the observational (AGCD) period of rainfall. However, the (AGCD) minimum and maximum temperature of a given date corresponds to two differing 24-hour periods (the minimum value corresponds to the 24 hours before 9 am and the maximum temperature corresponds to the 24 hours after 9 am). Further, the solar measurements are the average values from midnight to midnight for a given date, with daylight predominantly aligning with the 24 hours ending 9am the following day. The actual vapour pressure is measured at 9 am and 3 pm, and we use a weighted average of these values to correspond to the day following 9am. As a result, when the AWRA system reads in the input data files times are shifted as follows to represent the 24 hours to 9am used to timestamp AWRA-L outputs:
β€’ 𝑃𝑔 – as is (dated same as AWRA-L outputs)
β€’ 𝐾𝑑 – shift forwards 1 day
β€’ π‘‡π‘šπ‘Žπ‘₯ – shifted forwards 1 day
β€’ π‘‡π‘šπ‘–π‘› – as is (dated same as AWRA-L outputs)
β€’ 𝑒2 – as is (dated same as AWRA-L outputs)
β€’ 𝑝𝑒 – shifted forwards 1 day

The shifting of π‘‡π‘šπ‘Žπ‘₯ and 𝐾𝑑 was implemented for the first time in AWRA-L v7 to fit with the 9 am to 9 am day.

UPSHOT: We should use these time shift when working with both AGCD and AWRA data files.

Contributor guide

No contributing guide indexed for this repository

Research direction

No files, tests, or entry points are identified. Start by locating the notebooks or input-reading code that handles AGCD and AWRA data, then trace how each forcing variable is timestamped. Done means both data sources consistently apply the documented shifts for Kd, Tmax, and pe while leaving Pg, Tmin, and u2 unchanged.

Written by the indexing model from the issue text.

Assessment

Tech stack
jupyter-notebook
Domain
data-engineering
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.