The read_datamine macro reads datamine (.dm) format files.
| Name | Type | Description | |
| dir | string | Directory containing datamine files | |
| filenames | string[] | Array of datamine filenames | |
| Name | Type | Description | UI Control |
| model_as_point | boolean | Output points or hex boxes. | Toggle |
| model_scale | float | Specifies scale of hex boxes. | Slider |
| Name | Type | Description | |
| out_flds | Field[] | Array of fields read from datamine files. | |
| out_obj | GDobject | Directly renderable output object | |
The read_datamine macro allows a number of datamine (.dm) files to be read and outputs an array of fields containing the read data. The datamine file format was developed by Datamine International Ltd of the UK for their Datamine product. Further information on the Datamine International and their Datamine series of products can be found on their web-sites at www.datamine.co.uk or www.earthworks.com.au . Alternatively Datamine International can be contacted at the following address.
DATAMINE International The Old Deanery Stables Cathedral Green Wells Somerset BA5 2UE UK Tel. +44 1749 670097 Fax. +44 1749 670086 mailto:info@datamine.co.uk
Many thanks go to Ben Heather and Derk Erkelens of Datamine for providing the file format specification and example data files used in the development of this project.
dir
Name of the directory that the datamine files should be read from. The directory string should not end with a path separator (i.e. \ or /). The directory name can contain AVS/Express environment strings such as $XP_PATH<0>.
filenames[]
Array of strings containing the names of the datamine files that should be read.
model_as_point
Boolean parameter that specifies if 'blockmodel' type data should be output as points or as hex blocks. If the parameter is true point data will be output. This parameter is provided because datamine files can contain hundreds of thousands of blocks. Outputting these is points will greatly reduce the time taken to read and process the data.
model_scale
Floating point parameter that specifies how hex blocks should be scaled. A value of 1 implies that the blocks should not be scaled. If the file does not contain 'blockmodel' type data or the data is being read as points this parameter does not have any effect.
out_flds[]
Array of fields containing the data read from the specified datamine files. Each datamine file is read into a single field in a single element of the array. If a single field is required for visualization the extract_field macro can be used to select a single field from the array.
out_obj
The GDobject version of the output, suitable for direct connection to the viewer. It contains the array of fields present on the out_flds output port.
The ReadDatamineFunc functional macro uses the low-level ReadDatamineCore module. This functional macro and the ReadDatamineUI user interface macro are used by the read_datamine user macro. All of these macros use the ReadDatamineParams parameter block to communicate data.
The extract_field utility macro is also provided. This macro allows a single field to be extracted from the array of fields output by the the read_datamine macro. An example of the use of this macro can be seen in the ReadDatamineEg example application.
The project includes one example application that demonstrates the use of the read_datamine macro. The ReadDatamineEg application uses the read_datamine macro to read 4 datamine format files. These are output as an array of fields. extract_field and extract_component macros are used to extract a field containing a single set of node data from this array. This field is then displayed in the normal way.
iac_proj/rd_dmine/rd_dmods.v contains the V definitions of the ReadDatamineCore module and the ReadDatamineParams parameter block.
iac_proj/rd_dmine/rd_dmacs.v contains the V definitions of the ReadDatamineUI UI macro, the ReadDatamineFunc functional macro, the extract_field utility macro and the read_datamine user macro.
iac_proj/rd_dmine/rd_dapps.v contains the V definition of the ReadDatamineEg example application.
The low-level ReadDatamineMods library containing the low-level ReadDatamineCore module does not specify a process. By default the express process will be used.
Jeremy Maccelari, Visual Numerics
Andrew Dodd, International AVS Centre
International AVS Centre Manchester Visualization Centre Manchester Computing University of Manchester Oxford Road Manchester United Kingdom M13 9PL