write evs field
The write evs field module creates a file in one of several formats containing the mesh and nodal and/or cell data component information sent to the input port.
This module is useful for writing the output of modules which manipulate or interpolate data (3d estimation, 2d estimation, etc.) so that the data will not need to be processed in the future.
The saved and processed data can be read using read evs field, which is much faster than reprocessing the data.
Principal recommended format: EF2
The newest and strongly recommended format is EF2. This format is capable of containing additional field data and mesh types which are not supported in the legacy format. This is the only LOSSLESS format for current and future EVS fields. Although the files created in EF2 format are generally larger than EFBs, the further subsetting and/or processing of these updated fields can be dramatically more efficient.
- Uniform fields
- Geology (from gridding and horizons)
- Structured fields (such as irregular fields read in from read evs field)
- Unstructured Cell Data (UCD format) general grids with nodal and/or cell data
- Special fields containing spheres (which are points with radii)
- Special fields containing color data (such as LIDAR data)
Legacy formats:
- The legacy formats below were the recommended formats in software releases before 2024. With enhancements to EVS Fields, these formats must be considered LOSSY, meaning that some data and the (EF2) optimized grids will be compromised if these formats are used. We strongly recommend using the EF2 format.
- .eff ASCII format, best if you want to be able to open the file in an editor or print it. For a description of the EFF file formats click here.
- .efz GNU Zip compressed ASCII, same as .eff but in a zip archive
- .efb binary compressed format, the smallest and fastest format due to its binary form
Ports
| Direction | Name | Type | Description |
|---|---|---|---|
| Input | Input Field | Field | A field containing model to write to the EVS field file format. |
| Input | Geologic Legend Information | Geology Legend | Information required to properly label stratigraphic output or lithology within Legend. |
| Input | String 1 | String | A string to use as a variable. |
| Input | File Notes | String | Text containing the notes to be stored in the file. |
Properties
| Property | Type | Description |
|---|---|---|
| Filename | String | The output filename. Saves datasets in EVS/MVS compatible file formats (EF2, EFB, EFZ, EFF). |
| Check For Cell Set Data | Boolean | Causes any cell data that is constant throughout its cell set to be written as a cell set data component. |
| Translate By Origin | Boolean | Causes the output to be written in the user’s coordinate space. When turned off, the output will be written around the origin. |
Additional Information
| Property | Type | Description |
|---|---|---|
| Notes | String | Notes to include within the file. These are just comments and have no effect on the module. |
| Description | String | Allows the user to set the description in the output file. |
| Author | String | Allows the user to set the author name on the output file. |
| Organization | String | Allows the user to set the organization name on the output file. |
| Project | String | Allows the user to set the project displayed in the output file. |
| Status | String | Allows the user to set the status displayed in the output file. |
| Restrictions | String | Allows the user to set the restrictions displayed in the output file. |
Variables
| Property | Type | Description |
|---|---|---|
| S1 | String | A string value that can be used as the variable {S1} in the expression. |
Legacy File Options
| Property | Type | Description |
|---|---|---|
| Split Into Separate Files | Boolean | (Only applies to EFB/EFF/EFZ) Splits the output into separate files. The corresponding EFF or EFZ file will only contain the tag information. Any required nodes, data, or connectivity will be written into separate files. |
| Force Nodal Data In Output | Boolean | (Only applies to EFB/EFF/EFZ) Causes the field definition to always contain Node_Data. If this is off and there are no node data components, a simpler Mesh-Only style field will be saved. This causes a mesh to save as a Mesh+Node_Data (with 0 data components), which will allow many modules to work with this data. |
| Force Cell Data In Output | Boolean | (Only applies to EFB/EFF/EFZ) Same as above, but with cell data. Very few modules require cell data, so this is not on by default, but is provided as an option. |