User Tools

Site Tools


jvs:cigal:manual:chapter2:dmread

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

jvs:cigal:manual:chapter2:dmread [2011/03/31 14:49]
127.0.0.1 external edit
jvs:cigal:manual:chapter2:dmread [2023/02/23 18:43]
Line 1: Line 1:
-**CIGAL Reference Manual, Chapter 2 (Commands): dmread** 
-===== dmread -- Read paradigm related data in DM archive format ===== 
-**usage: dmread filename datavarb recflg [hdrtxt hdrflag]** 
- 
-DMREAD reads data written by DMWRITE from the named data management (DM) archive file. This file format is described in [[jvs:cigal:manual:chapter5:dmformat|DM Format]]. Records read by DMREAD can be displayed on the screen (if they are text records) or stored in a CIGAL data variable. Records in a DM file are accessed either by record number or by record type, using the RECFLG argument. 
- 
-FILENAME must be the name of a data file in archive format.\\ 
-If the archive file is the only argument, DMREAD will display a list of all records in the file. 
- 
-RECFLG can be: 
-  * > 0 - The record type, defined when the record was written (see [[jvs:cigal:manual:chapter6:dmwrite|DMWRITE(6)]]) 
-  * < 0 - The negative record number (Recnum = -RECFLG) (the first record is 1) 
-  * = 0 - This displays the complete file header; this also returns the number of records in the file in register r0 
- 
-DATAVARB 
- 
- 
-If a character string argument is specified for HDRTXT it will receive the 
-comment text associated with the retrieved record.  If HDRFLAG is 1, DMREAD 
-returns header information for the specified record by loading DATAVARB with 
-a 7 element LONG array containing the following information: 
-         RECNUM       Record number 
-         RECSIZE      Size of record in bytes 
-         RECOFFSET    Byte offset of data 
-         RECTYPE      Record type 
-         WTYPE        PIXTYPE for data 
-         NX           X dim, or 1 + # of Xprime values if XXprime format 
-         WTYPEY       PIXTYPE for Xprime data (if NVALS > 0) 
- 
-**See Also:**\\ 
-[[jvs:cigal:manual:chapter6:dmwrite|DMWRITE(6)]] 
- 
-[[jvs:cigal|CIGAL Home]],  
-[[jvs:cigal:manual|CIGAL Manual]],  
-[[jvs:cigal:manual:chapter2|Commands List]],  
-[[jvs:cigal:manual:help|Manual Help]] 
  
jvs/cigal/manual/chapter2/dmread.txt · Last modified: 2023/02/23 18:43 (external edit)