# Timestep in FieldData

**URL:** https://discourse.paraview.org/t/timestep-in-fielddata/9139
**Category:** ParaView Support
**Tags:** vtk
**Created:** [March 7, 2022, 9:47pm UTC](https://discourse.paraview.org/t/timestep-in-fielddata/9139 "2022-03-07T21:47:05Z")
**Posts on this page:** 3
**Page:** 1

<div class="post-metadata">

### Author: ![jpmorr](https://discourse.paraview.org/user_avatar/discourse.paraview.org/jpmorr/32/8745_2.png) [@jpmorr](https://discourse.paraview.org/u/jpmorr)
#### Post date: [March 7, 2022, 9:47pm UTC](https://discourse.paraview.org/t/timestep-in-fielddata/9139/1 "2022-03-07T21:47:05Z")

</div>

I’m trying to understand how to Use `FieldData` and other possible uses of `FieldData`.

I understand that one of the main uses is to store the time or timesteps associated with a file. However, I’m not sure if there is a specific format or specification for doing this. For example, when I export data from ParaView from example data created by some other solver, the `FieldData` contains both `TimeValue` and `TIME`.

```auto
    <FieldData>
      <DataArray type="Float64" Name="TIME" NumberOfTuples="1" format="ascii" RangeMin="0.00022002" RangeMax="0.00022002">
        0.00022002
      </DataArray>
      <DataArray type="Float64" Name="TimeValue" NumberOfTuples="1" format="ascii" RangeMin="1" RangeMax="1">
        1
      </DataArray>
    </FieldData>

```

In this example, `TIME` is the real time in seconds whereas `TimeValue` seems to be the file number in the group of files. But why is `TimeValue` an `Int` stored as a `Float`? I’m not sure what Is going on here - Do I always need to include `TIME` and `TimeValue`? Or is one of the two sufficient for ParaView to figure out what is going on?

And what about `NumberOfTuples`? Wil this always be 1? Can you have `FieldData` that has more than one `tuple`?

There’s not much documentation on this, or at least not that I could easily find anyway.

The last part of my question is what else can you use `FieldData` for? Is there a good example xml file showing it’s usage?

---

<div class="post-metadata">

### Author: ![mwestphal](https://discourse.paraview.org/user_avatar/discourse.paraview.org/mwestphal/32/17_2.png) [@mwestphal](https://discourse.paraview.org/u/mwestphal)
#### Post date: [March 8, 2022, 8:01am UTC](https://discourse.paraview.org/t/timestep-in-fielddata/9139/2 "2022-03-08T08:01:25Z")

</div>

> [@jpmorr](#):
>
> I understand that one of the main uses is to store the time or timesteps associated with a file. However, I’m not sure if there is a specific format or specification for doing this. For example, when I export data from ParaView from example data created by some other solver, the `FieldData` contains both `TimeValue` and `TIME`.

The XML readers exploit the “TimeValue” field data information to provide the right temporal information to VTK pipeline, which in turn is used by ParaView.

I do not see any usage of “TIME” anywhere.

> And what about `NumberOfTuples`? Wil this always be 1? Can you have `FieldData` that has more than one `tuple`?

Yes, not an issue.

> There’s not much documentation on this, or at least not that I could easily find anyway.

This is because this is not about VTK and ParaView but about the XML readers that treat this data from file and then pass it down to VTK.

This TimeValue mechanism is documented here: [VTK: Field Data as Time Meta-Data in VTK XML File Formats](https://vtk.org/doc/nightly/html/md__builds_gitlab_kitware_sciviz_ci_Documentation_Doxygen_IOXMLTimeInFieldData.html).

Other usage of FieldData in ParaView is classicaly the composite dataset where field data is used to color block by block.

There is however currently an issue with that: [https://gitlab.kitware.com/paraview/paraview/-/issues/20748](https://gitlab.kitware.com/paraview/paraview/-/issues/20748)

---

<div class="post-metadata">

### Author: ![jpmorr](https://discourse.paraview.org/user_avatar/discourse.paraview.org/jpmorr/32/8745_2.png) [@jpmorr](https://discourse.paraview.org/u/jpmorr)
#### Post date: [March 8, 2022, 4:27pm UTC](https://discourse.paraview.org/t/timestep-in-fielddata/9139/3 "2022-03-08T16:27:13Z")

</div>

Thanks. After looking at this in a bit more detail now I believe the reason I have `TIME` and `TimeValue` is because the file was originally read in from the legacy format and then later exported in the newer `XML` format and the conversion was not made automatically within ParaView it seems.

But I think my confusion is cleared up.
