diskdata

Purpose

Read in or write an array or set of strings to a file.

Synopsis

procedure diskdata(format:integer, file:string, a:array)

procedure diskdata(format:integer, file:string, s:set)

procedure diskdata(format:integer, file:string, l:list)

Arguments

format

Format options:

ETC_DENSE	dense data format
ETC_SPARSE	sparse data format
ETC_SGLQ	strings quoted with single quotes
ETC_NOQ	strings are not quoted in the file
ETC_OUT	write to a file
ETC_APPEND	append output to the end of an existing file
ETC_TRANS	tables are transposed
ETC_IN	read from file (default)
ETC_NOZEROS	skip zero values
ETC_CSV	use CSV format
ETC_SKIPH	skip first line (header) of the file
ETC_AUTONDX	similar to sparse format but indices are not read or written (only applies to 1-dimension arrays indiced by ranges)
ETC_EMPTYNDX	missing indices are replaced by a default value
ETC_DATAFRAME	dense data format for a 2-dimension array and first index as a range (for the line numbers)

Several options may be combined using ` +'.

file

Extended file name

Array to export or initialize

Set to export or initialize

List to export or initialize

Example

The following example declares two sets and two dynamic arrays. The array ar1 is read in from the file in.dat. Then both arrays, ar1 and ar2, are saved to the file out.dat (in sparse format) and finally the contents of the set Set1 is appended to the file out.dat.

declarations
 Set1: set of string
 R: range
 ar1,ar2: array(Set1,R) of real
end-declarations

diskdata(ETC_SPARSE, "in.dat", ar1)
diskdata(ETC_OUT, "out.dat", [ar1, ar2])
diskdata(ETC_OUT+ETC_APPEND, "out.dat", Set1)

Further information

1. This procedure reads in data from a file or writes to a file, depending on the parameter settings. The file format used is compatible with the command DISKDATA of the modeler mp-model (unless the option ETC_CSV is specified).

2. Only arrays lists and sets of basic and native types (including mpvar and linctr for writing) can be used with this procedure, in particular records are not supported.

3. If option "dataframe" is combined with "skiph" the array to be processed must be indiced by a range and a set of strings. The second index is automatically populated with the column names of the header row when reading (the same line is generated when writing).

Module

mmetc

Contents

Index

Glossary

Search Results

diskdata

diskdata