read evs field
read evs field reads a dataset from the primary and legacy file formats created by write evs field.
- .EF2: The only Lossless format for models created in 2024 and later versions
- .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 & fastest format due to its binary form
Output Quality: An important feature of read evs field is the ability to specify two separate files which correspond to High Quality (e.g. fine grids) and Low Quality (e.g. coarse grids a.k.a. fast).
You can see that read evs field is specifying two different EFB files. The Output Quality is set to Highest Quality and is Linked (black circle). The viewer shows:
If we change the Output Quality on the Home Tab
It changes the setting in read evs field and the viewer changes to show:
Though you “can” change the Output Quality in read evs field, it is best to change it on the Home Tab to make sure that all read evs field modules in your application will have the same setting. This is not relevant to this simple application, but if we were using a cutting surface (saved as fine and coarse EFBs) and doing distance to surface operations on a very large grid, this synchronization would be important.
read evs field effectively has explode_and_scale and an external_faces module built in. This allows the module to perform Z Scaling, Exploding, Nodal or Cell data selection, and selection of cell sets.
Ports
| Direction | Name | Type | Description |
|---|---|---|---|
| Input | Input Z Scale | Number | The factor for vertical scaling. |
| Input | Input Explode | Number | The value used for separating output based on geology. |
| Output | File Notes | String | Text containing the notes stored in the file. |
| Output | Output | Field | A field containing EVS field file contents. |
| Output | Output Object | Renderable | A renderable object displaying the EVS field file contents. |
| Output | Geologic Legend Information | Geology Legend | Information required to properly label stratigraphic output or lithology within Legend. |
| Output | Output Z Scale | Number | The factor for vertical scaling. |
| Output | Output Explode | Number | The value used for separating output based on geology. |
Properties
| Property | Type | Description |
|---|---|---|
| Filename | String | The field file to read. |
| Execute | Button | This button will force the module to run even if the Allow Run toggle has been turned off. This allows the user to make a number of changes before updating. |
| Allow Run | Boolean | The Allow Run toggle, when deselected, will prevent the module from running. |
| Output Quality | Choice: Highest Quality, Fast | The output quality setting controls whether to use the high quality or low quality file. |
| Low Quality Filename | String | The field file to read when in low output quality mode. |
| Z Scale | Double | The Z Scale is the vertical exaggeration to be applied to the output object. |
| Explode | Double | The Explode value is the distance between exploded layers, cell sets or materials. For example, an explode distance of 20 will separate each geologic layer by 20 feet from the layer above it and the layer below it. Note that the explode distance incorporates the scale factor, so that if a scaling factor of 5 is specified for a 10 foot thick layer to which an explode factor of 20 is applied, the geologic layers will be separated by 100 feet. |
| Vertical Offset | Double | Vertical Offset translates your entire model in Z by the value input multiplied by the Z Exaggeration. This is useful if you want to move your model to avoid having coincident objects. |
| Handle Application Origin | Boolean | The Handle Application Origin setting controls whether the geometry in an EF2 file is automatically translated to application origin or read without any modifications. |
Explode And Scale Settings
| Property | Type | Description |
|---|---|---|
| Explode By | Choice: Layer, Material, Cell Set, Lithology | The Explode By options determine what information is used to explode the layers or materials. Layer and Material are nodal data components that should be present with any hierarchical geologic model. The Cell Set option allows you to explode by the Cell Set number. The Lithology option is to be used only with Adaptive Indicator Kriged geologic models. These models have a cell data component called Lithology which corresponds to integer values assigned to material regions. |
| Explode Begins | Integer | Explode Begins determines the first layer or material that will be exploded. |
| Explode Ends | Integer | Explode Ends sets the last layer/material which will be exploded. This value defaults to -1 which will explode all remaining layers or materials. |
| Cell Sets | Multi-select | The Cell Sets control allows selected cell sets to be turned off in the output. |
File Information
| Property | Type | Description |
|---|---|---|
| Author | String | Display the Author of the file. |
| Organization | String | Display the Organization of the file. |
| Project Name | String | Display the Project Name of the file. |
| Restrictions | String | Display the Restrictions information of the file. |
| Status | String | Display the Status information of the file. |
| Creation Date | String | Display the Creation Date if it is set in the file. |
| Description | String | Display the Description of the file. |
| File Notes | String | Display the File Notes if they are set in the file. |
EVS Field File Formats and Examples EVS Field file formats supplant the need for UCD, netCDF, Field (.fld), EVS_Geology by incorporating all of their functionality and more in a new file format with three mode options. .eff ASCII format, best if you want to be able to open the file in an editor or print it