-
Notifications
You must be signed in to change notification settings - Fork 29
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.
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
Make "time", "dt", "timeOffset" and "timeUnitSI" optional #201
base: upcoming-2.0.0
Are you sure you want to change the base?
Conversation
@@ -233,9 +233,10 @@ Required Attributes for the `basePath` | |||
-------------------------------------- |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The title in line 232 still reads "Required" :)
Do we want to make this optional or recommended?
@@ -661,6 +662,7 @@ Reminder: for scalar records the `record` itself is also the `component`. | |||
|
|||
- `timeOffset` | |||
- type: *(floatX)* | |||
- scope: *optional* (only used if `time` and `dt` are used) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe let's move this from Required for each Record
to a section optional (or recommended if we decide so).
files (`fileBased`) or series of groups (`groupBased`) can have | ||
attributes that describe the current time and the last time step. (In the | ||
case where each iteration corresponds to a different time.) Thus, the | ||
following attributes are *optional*: | ||
|
||
- `time` | ||
- type: *(floatX)* |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
let's fix the typo in line 264 at the same time: conversion factor
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
timeUnitSI
should be made optional
as well but required if time
or dt
is set
This makes the attributes "time", "dt", "timeOffset" and "timeUnitSI" optional.
Implements issue: #161
Description
As detailed description as possible.
What is introduced, removed or renamed and why?
What is made required, recommended, optional?
What concept stands behind this change?
Please also add an example.
Affected Components
base
Logic Changes
Which logic changes are conceptually introduced?
@RemiLehe please describe how a reader should handle time now. What if only few of the attributes are present? What if a mesh is read that has a temporal axis? #193 Or a particle record with
unitDimension
time? What are defaults in such a case and what quantities are additive?Writer Changes
The above attributes are now optional
openPMD-api
: https://github.com/openPMD/openPMD-api/...Reader Changes
Readers cannot explicitly assume that these attributes are present.
openPMD-validator
: https://github.com/openPMD/openPMD-validator/...openPMD-viewer
: https://github.com/openPMD/openPMD-viewer/...yt
: https://github.com/yt-project/yt/...VisIt
: https://github.com/openPMD/openPMD-visit-pluginopenPMD-api
(upcoming): https://github.com/openPMD/openPMD-api/...XDMF
(upcoming): https://github.com/openPMD/openPMD-converter/...Data Updater
Not needed.