Open a gnuplot file for visualization of images and control values.
gnuplot_open_file allows the output of images and control values in a format which can be later processed by gnuplot. The parameter FileName determines the base-name of the files to be created by calls to gnuplot_plot_image. gnuplot_open_file generates a gnuplot control file with the name <Filename>.gp, in which the respective plot commands are written. Each image plotted by gnuplot_plot_image (or control values plotted by gnuplot_plot_ctrl) creates a data file with the name Filename.dat.<Number>, where Number is the number of the plot in the current sequence. The generated control file can later be edited to create the desired effect. After the last plot gnuplot_close has to be called in order to close all open files. The corresponding identifier for the gnuplot output stream is returned in GnuplotFileID.
|
FileName (input_control) |
filename -> string |
| Base name for control and data files. | |
|
GnuplotFileID (output_control) |
gnuplot_id -> integer |
| Identifier for the gnuplot output stream. | |
gnuplot_open_file returns the value 2 (H_MSG_TRUE) if the control file could be opened. Otherwise, an exception handling is raised.
gnuplot_open_file is processed completely exclusively without parallelization.
gnuplot_plot_image, gnuplot_close
gnuplot_open_pipe, gnuplot_close, gnuplot_plot_image
System
