file statistics
The file statistics module is used to check the format of .apdv, .aidv, .geo, .gmf, .vdf, and .pgf files, and to calculate and display statistics about the data contained in these files. This module also calculates a frequency distribution of properties in the file. During execution, file statistics reads the file, displays an error message if the file contains errors in format or numeric values, and then displays the statistical results in the EVS Information window.
Ports
| Direction | Name | Type | Description |
|---|---|---|---|
| Input | Input Filename | String | File used to display data. |
| Input | Input Z Scale | Number | The factor for vertical scaling. |
| Output | Output Filename | String | File used to display data. |
| Output | Output Z Scale | Number | The factor for vertical scaling. |
| Output | Sample Data | Field | A field containing the sample point data. |
| Output | Sample Object | Renderable | A renderable object displaying the sample data. |
| Output | Mean Level | Number | The calculated mean value. |
| Output | Median Level | Number | The calculated median value. |
| Output | Minimum Level | Number | The calculated minimum value. |
| Output | Maximum Level | Number | The calculated maximum value. |
| Output | Number Of Points | Number | The input number of points. |
| Output | Statistics | String | String representing the calculated statistics. |
Properties
| Property | Type | Description |
|---|---|---|
| Allow Run | Boolean | This toggle can prevent the module from running. Allowing the user to make changes to large data sets without waiting for updates. |
| 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. |
| Filename | File | The file name to process for display. |
| Use Application Origin | Boolean | When true, the module will apply the Application Origin. When false, data will be left in internal model space. Turn off when loading data intended to use as a glyph or similar. |
Data Processing
| Property | Type | Description |
|---|---|---|
| Component Or Layer | Integer | The Data Component is used to select which file data component to process for display. |
| Data Processing | Choice: Linear Processing, Log Processing | Data Processing will allow the module to be run in either Linear or Log Space. |
| Z Scale | Double | The Z Scale is the vertical exaggeration to be applied to the output object. |
| Log Post Processing Clip Min | Double | Post Processing Clip Min will be used after data processing to replace any sample property value that is less than the specified number in log space. |
| Linear Post Processing Clip Min | Double | Linear Post Processing Clip Min will be used after data processing to replace any sample property value that is less than the specified number in linear space. |
| Detection Limit | Double | The Detection Limit value affects any file values set with the ‘ND’ or other non-detect flags. When the module encounters this flag in the file it will insert a value equal to (Detection Limit * LT Multiplier). |
| Less Than Multiplier | Double | The Less Than Multiplier is the value applied to any sample with the ‘<’ less than flag. |
| Number Of Bins | Integer | The Number of Bins value allows the user to specify the bins that will be used to calculate the frequency histogram. The default value of 0 does not calculate a frequency distribution during execution of the module. The user can select any number of bins from 2 to 255 (note that a value of 1 is not valid). |
| Delimiter | String | The Delimiter specifies how the labels and values in the Output Log are separated. The word TAB will be replaced by a tab advancement. |
| Coordinate Precision | Integer | The Coordinate Precision is the number of decimal points to use for coordinate values. |
| Format Data | Number Formatting | The Format Data control allows the user to set how data will be formatted for display. |
| Detailed Statistics | Boolean | The Detail Statistics toggle causes the module to display the original statistical information along with more detailed statistics. |
Glyph Settings
| Property | Type | Description |
|---|---|---|
| Points As Glyphs | Boolean | The Points As Glyphs toggle will cause the points to be displayed as a user selected glyph. |
| Point Width | Integer | The Point Width sets the size of the rendered pixels. The default is 0 which is equivalent to 1. |
| Glyph Size | Double | The Glyph Size value is used to scale the glyphs in all directions. The default is automatically computed based on your input data. |
| Priority | Choice: Maximum, Minimum | The Priority of the glyph will reverse the scaling so that the smallest sample values have the largest size. |
| Minimum Scale Factor | Double | The Minimum Scale Factor scales the sample values with the least Priority. |
| Maximum Scale Factor | Double | The Maximum Scale Factor scales the sample values with the greatest Priority. |
| Use Log Data | Boolean | The Use Log Data toggle will force the size of the glyph to be based on the log10 of the selected data. |
| Generated Glyph | Choice: Sphere, Cube, Cone, Cylinder, Polygon, Disk | The Generated Glyph choice allows the user to select the type of glyph that is automatically generated. |
| Sphere Subdivisions | Integer | The Sphere Subdivisions defines how finely the sample spheres are rendered. Higher values mean smoother spheres but at a higher memory cost. |
| Glyph Resolution | Integer | The resolution for generated cone, polygon, cylinder, and disk glyphs. |
| Primary Axis Factor | Double | The scale factor for the primary axis of the glyph. |
| Secondary Axis Factor | Double | The scale factor for the secondary axis of the glyph. |
| Heading Dip | Heading/Dip | The Heading and Dip values are used to align the glyphs to a constant orientation. |
| Roll | Double | The roll of the glyph along its primary axis. |
Time Settings
| Property | Type | Description |
|---|---|---|
| Chem File Is Time Domain | Boolean | The Chem File is Time Domain toggle turns on date interpolation for time domain analyte (e.g. chemistry) files. |
| Specify Date By Component | Boolean | The Specify Date by Component toggle will cause the Date field to be ignored and the date to be selected using the Data Component. |
| Date For Interpolation | Date | The Date For Interpolation field is the date being interpolated to. The Date can be either set here or passed in via the Date port. |
| Analyte Name | String | The Analyte Name field is used for AIDV and APDV time files as the dates take up the spots in these files usually reserved for analyte names. |
| Interpolation Type | Choice: Direct Interpolation Only, Interpolate Only, Interpolate and Extrapolate Beyond, Interpolate and Extrapolate, Interpolate (Use with Shrink) | There are 5 different Interpolation Methods that are available, each interpolation method is used to define how to interpolate when given non-detects in a file. |
| Use Nearest Measured Data | Boolean | The Use Nearest Measured Data toggle causes the sample at the interpolated date, to have the same value as the nearest measured date and not an interpolated value. |
| Non Linear Shrink | Boolean | If the Non-Linear Shrink toggle is selected the size of the sphere will be determined by a cosine interpolation instead of a linear one. |