GENESIS offers several routines to read or write data from within the GENESIS environment to an operating system file, or to prompt the user for information.
Routine | Description |
openfile | Opens ASCII file for reading or writing. |
listfiles | Lists ASCII files currently opened by openfiles command. |
closefile | Closes an ASCII file opened with the openfile command. |
flushfile | Flushes buffered data to disk to insure that it gets written. |
readfile | Reads a line of data from an opened ASCII file. |
writefile | Writes out ASCII data to currently opened file. |
eof | Tests whether at end of currently opened file. |
asciidata | Converts a FMT1 formatted binary file to ASCII. |
logfile | Activates and deactivates logging of all commands issued in |
a GENESIS session. | |
notes | Allows user to enter text notes into a file. |
include | In a script, reads in the contents of another GENESIS script. |
where | Returns name of operating-system directory in which specified |
file is located. | |
input | Obtains input from the user at the GENESIS prompt. |
The simdump command and its auxillary commands are used to dump an entire simulation to a GENESIS script file, complete with the current values of specified element fields. This file may then be loaded into GENESIS to recreate the simulation. This is in contrast to the save and restore commands, which are used for specified (or wildcarded) elements in a simulation.
Routine | Description |
enddump | Cleans up at the end of a dumpfile |
initdump | Initializes the simulation dumping/undumping system |
simdump | Dumps an entire simulation to a GENESIS script file |
simobjdump | Sets up format for dumping/reading objects to a file |
simundump | Creates an element and assigns values to its fields |
swapdump | Mirrors initialization data when doing simulation dumps |
save | Saves current field values for specified element in a file |
restore | Restores element state stored in file with save routine |
Often, one would like to write or read data at regular intervals, using one of the available simulation clocks. The GENESIS objects asc_file , disk_out , and disk_in may be used for this purpose. The diskio , variable , and metadata objects provide the features of the existing disk_in and disk_out objects to read and write data in the portable binary NETCDF format. This eases the interfacing of GENESIS simulations with popular analysis and signal-processing tools such as MATLAB, and makes it possible to use binary files produced by GENESIS on multiple platforms. For examples of ``clocked file I/O'', see the documentation for these objects in the GENESIS Object Reference.