Skip to content

MARS-007 Document timespan behaviour, especially timespan=none#54

Merged
simondsmart merged 3 commits intomainfrom
mars-timespan-none
Apr 1, 2026
Merged

MARS-007 Document timespan behaviour, especially timespan=none#54
simondsmart merged 3 commits intomainfrom
mars-timespan-none

Conversation

@simondsmart
Copy link
Copy Markdown
Contributor

Description

Contributor Declaration

By opening this pull request, I affirm the following:

  • All authors agree to the Contributor License Agreement.
  • The code follows the project's coding standards.
  • I have performed self-review and added comments where needed.
  • I have added or updated tests to verify that my changes are effective and functional.
  • I have run all existing tests and confirmed they pass.

- On archive, this uses the value provided if supplied. This must match the `mars` namespace, and so will be absent for pre-MTG2 data, and present for post-.
- On retrieve, both `timespan=none` and `timespan` absent match against either `timespan=none` or `timespan` absent in the fdb index.
- This could be proposed as a standard behaviour going forward.
- We pre-analyse data in the MARS client, prior to submitting an archive request using explicit eccodes calls to determine if we are pre/post MTG2
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This doesn't match what is written in the decision. We state below that archive/wipe must match the contents of the MARS namespace. That is probably correct. As written is very much optional (and probably not ideal)

- We introduce a new semantic for the MARS language.
* `keyword=none` is strictly equivalent to `keyword` unspecified
* This behaviour can be extended to other contexts in the future, where appropriate, but should be consistent in all cases.
New development required
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Newlines here being lost in formatting. Need to add more newlines...

@simondsmart simondsmart merged commit 62fa39d into main Apr 1, 2026
1 check passed
@simondsmart simondsmart deleted the mars-timespan-none branch April 1, 2026 13:56
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