pictures/imod_logo.png

iMOD User Manual version 4.4 (html)


8.12PLOT-Function

The Plot function can be used to construct figures that are normally displayed on the graphical display of iMOD.

FUNCTION=

PLOT

OUTFILE=

Enter the name of the output filename. The format of the image depends on the extension of the filename:
  • • *.BMP : Windows Bitmap;

  • • *.PCX : ZSoft PC Paintbrush;

  • • *.PNG : Portable Network Graphic image;

    • *.JPG : JPEG/JFIF image.

IDFFILE=
(optional)

Enter the name of an *.IDF-file that needs to be plotted, for example IDFFILE=D:\AHN.IDF.

IDFLEGFILE=
(optional)

Enter the name of a *.LEG file that needs to be used for colouring the *.IDF-file. If no IDFLEGFILE is given, iMOD will apply a default iMOD Legend based on a linear distribution of IDF values.

IDFLEGCOL=
(optional)

Enter the number of columns to be used for the legend to be plotted, e.g. IDFLEGCOL=3 to present the legend in 3 columns. By default IDFLEGCOL=1.

IDFLEGTXT=
(optional)

Enter the text to be added to the legend, e.g. IDFLEGTXT=”Transmissivity (m2/day)”. By default no legend text will be displayed.

IDFSTYLE=
(optional)

Specify whether the IDF need to be displayed as grid values, contourlines, vectors or all three combined. For example IDFSTYLE=111 will plot the IDF-file by all styles, default IDFSTYLE=100. Use the following syntax to specify the style to be used, any combination is possible:

100

IDF will be displayed as filled rectangles.

010

IDF will be contoured.

001

IDF will be displayed as arrows based on the gradient in the IDF file.

IPFFILE=
(optional)

Enter the name of an IPF file to be plotted, for example IPFFILE=D:\DATA.IPF. iMOD will use the first and second column in the IPF for the x- and y coordinate and displays the point in red circles. Use the other keywords to change these settings.

IPFXCOL=
(optional)

Specify the column to be used for the x-coordinate, by default IPFXCOL=1

IPFYCOL=
(optional)

Specify the column to be used for the y-coordinate, by default IPFYCOL=2

IPFHCOL=
(optional)

Specify the column to scale the dots that have larger values than others, those will be displayed as an increased marker symbol. iMOD will scale the values based on the entries at the keyword IPHCOL_M. By default IPFHCOL=0.

IPFHCOL_M=
(optional)

Specify the methodology to scale the symbol, by default IPFHCOL=0 and no scaling applies. iMOD displays them, such that small symbol sizes will be plotted upon large symbols, choose a method from the following:

1

iMOD scales the values for IPFHCOL linearly from large up to small using 4 sizes (sizes 1,2,3 and 4).

2

iMOD scales the values for IPFHCOL linearly from large up to small using 4 sizes (sizes 1,2,3 and 4) within the range of the entered legend.

3

iMOD scales the absolute values for IPFHCOL linearly from large up to small using 4 sizes (sizes 1,2,3 and 4).

4

iMOD scales the symbols using the direct value for IPFHCOL, sizes need to be positive, negative entries will be as treated as positive sizes.

IPFASSFILES=
(optional)

Specify whether to plot the graph (e.g. timeseries, boreholes) described in the associated TXT files linked by the IPFFILE. Specify IPFASSFILES=1 to plot a simple graph (without axes) and IPFASSFILES=2 to plot a advanced graph with axes. By default IPFASSFILES=0 and no associated text files are displayed.

IPFASSFILES_
ALL=
(optional)

Specify whether to plot the content of all associated TXT files in a single image (IPFASSFILES_ALL=1) or alternatively, plot each TXT file in a separate image (IPFASSFILES_ALL=2). In that case the OUTFILE will be created automatically by the name of the individual points given by the column denoted by the IEXT, see Section 9.7 for more information on IPF files.

IPFSTYLE=
(optional)

Specify the style to be used to plot the points. Use the following options:

0

Use this style to display the points as solid circles.

1

Use this style to colour the points by the labels in the column IPFLCOL in combination with the specified legend in LEGFILE.

Specify the following whenever IPFSTYLE=1

IPFLEGFILE=
(optional)

Enter the appropriate legend file to be used, e.g. IPFLEGFILE=D:\RESIDUAL.LEG

IPFLEGCOL=
(optional)

Enter the name of a *.LEG file that needs to be used for colouring the *.IPF-file. If no IPFLEGCOL is given, iMOD will apply a default iMOD Legend based on a linear distribution of IDF values.

IPFLCOL=

Specify the column in the IPF file for the colouring of points, needed whenever IPFLEGFILE is specified.

IPFLEGTXT=
(optional)

Enter the text to be added to the legend, e.g. IPFLEGTXT=”Residual (m)”. By default, whenever the keyword is absent, no legend text will be displayed.

NLABELS=
(optional)

Specify the total number of labels to be plotted, e.g. NLABELS=3. By default NLABELS=0 and no labels (i.e. columns in the IPF file) will be plotted.

ILABELS=

Specify the number of individual labels (i.e. the columns in the IPF file) to be plotted, e.g. ILABELS=3,5,7 and NLABELS=3.

IFFFILE=
(optional)

Enter the name of an IFF file to be plotted, for example IFFFILE=D:\MODEL\FLOW.IFF. iMOD will plot the lines in coloured by the sixth column in the IFF file (normally that is the attribute CUMTT).

IFFLEGFILE=
(optional)

Enter the appropriate legend file to be used, e.g. IFFLEGFILE=D:\CUMTT.LEG. By default no legend is used.

IFFLEGCOL=
(optional)

Enter the name of a *.LEG file that needs to be used for colouring the *.IFF-file. If no IFFLEGCOL is given, iMOD will apply a default iMOD Legend based on a linear distribution of IDF values.

IFFLEGTEXT=
(optional)

Enter the text to be added to the legend, e.g. IDFLEGTXT=”Cumulative Time (years)”. By default no legend text will be displayed.

NGEN=
(optional)

Enter the number of GEN files to be included, e.g. NGEN=3.

GENFILE{i}=

Enter the name of a *.GEN-file that needs to be plotted on the background. On default the line, points and/or polygons in the GENFILE, will be drawn as black features, e.g. GENFILE1=D:\GENS\TOPOGRAPHY.GEN. This keyword need to be repeated for NGEN-times.

GENCOLOUR{i}=
(optional)

Enter a colour number to be used colouring the i\({}^{th}\) GEN file specified by GENFILE{i}. By default a black line will be plotted. Specify a colour by red, green and blue components, e.g. GENCOLOUR1=255,0,0 to express full red. Use GENCOLOUR1=0,0,0 to specify black and GENCOLOUR1=255,255,255 to set white.

GENTHICK
NESS{i}=
(optional)

Enter a line thickness to be used for the i\({}^{th}\) GEN file specified by GENFILE{i}. By default GENTHICKNESS1=1 and a line thickness of 1 will be applied, e.g. GENTHICKNESS1=5 to express a line thickness of 5.

TOP25=
(optional)

Enter the location of the CRD-file (see Section 9.19 for the syntax of such a file), used by iMOD to display ... background images, e.g. TOP25=d:\TOP25\BMPCRD.CRD.

WINDOW=
(optional)

Enter the coordinates of the window that needs to be displayed. Enter coordinates of the lower-left corner first and then the coordinates of the upper-right corner, e.g. WINDOW=100000.0, 400000.0, 200000.0, 425000.0. When the keyword is absent, the figure will be displayed at the maximum extent of the entered filenames at the keywords IDFFILE, IPFFILE and/or IFFFILE.


The following keywords need to be all defined in order to generate more sophisticated display, including legend boxes and figure labels.

TITLE=

Enter a name for the main title of the figure, e.g. TITLE=”Effect of an Increased Well Capacity on Groundwater Levels”. Use quotes for titles that contain spaces.

SUBTITLE=

Enter a string for a subtitle, e.g. SUBTITLE=”Financed by European Union”. Use quotes for titles that contain spaces.

FIGTXT=

Enter a figure identification, e.g. FIGTXT=”Figure 1-a”. Use quotes for titles that contain spaces.

PRJTXT=

Enter a description of the project, e.g. PRJTXT=”iMOD Groundwater Flow Model”. Use quotes for titles that contain spaces.

YFRAC-LEGEND=
(optional)

Enter the percentage (0-100%) of the legend occupation in the legend area, e.g. YFRACLEGEND=50.0 means that the legend will be placed in 50% of the total legend area. On default YFRACLEGEND=100.0, so the entire legend area will be used.

RESOLUTION=
(optional)

Enter the resolution of the bitmap, i.e. the number of pixels. On default RESOLUTION=3200. Higher resolutions will yield more accurate images.

Example 1

FUNCTION=PLOT
IDFFILE=D:\TUTORIAL\iMODBATCH\AHN.IDF
IDFSTYLE=100
NGEN=1
GENFILE1=D:\TUTORIAL\iMODBATCH\PROVINCES.GEN
OUTFILE=D:\TUTORIAL\iMODBATCH\AHN.png

As a result of the above described content the following figure will be created:

pictures/h6-h71/image922.png

Example 2

FUNCTION=PLOT
IDFFILE=D:\TUTORIAL\iMODBATCH\AHN.IDF
IDFSTYLE=100
IDFLEGFILE=TUTORIAL\AHN.LEG
IDFLEGTXT=’Surface Level (m+MSL)
IDFLEGCOL=2
NGEN=1
GENFILE1=D:\TUTORIAL\iMODBATCH\PROVINCES.GEN
TITLE=’Surface Level’
SUBTITLE=’Dutch Altimeter Level obtained by Laser-Altimetry 2002/2011’
FIGTXT=’1A DELTARES2011-Conf.’
PRJTXT=’Netherlands Hydrological Instrument, Deltares’
OUTFILE=D:\TUTORIAL\iMODBATCH\AHN.png

As a result of the above described content the following figure will be created.

Advanced example of a resulting bitmap:

pictures/h6-h71/image923.png

Example 3

FUNCTION=PLOT
IDFFILE=D:\IMOD-TEST\PLOT\BATHEMETRY.IDF
IDFLEGFILE=D:\iMOD-TEST\PLOT\LEGEND.LEG
IDFSTYLE=010
IPFFILE=D:\iMOD-TEST\PLOT\BATHYMETRY.IPF
IPFXCOL=2
IPFYCOL=1
IPFLCOL=3
IPFSTYLE=1
IPFLEGFILE=D:\iMOD-TEST\PLOT\LEGEND.LEG
NLABELS=1
ILABELS=3
NGEN=2
GENFILE1=D:\PROVINCES.GEN
GENFILE2=D:\FAULTS.GEN
OUTFILE=D:\IMOD-TEST\PLOT\BATHEMETRY.png

pictures/h6-h71/image924.png

Example 4

FUNCTION=PLOT
IPFFILE=D:\TUTORIAL\iMODBATCH\MEASURE.IPF
IPFASSFILES=2
IPFASSFILES_ALL=1
TOP25=D:\TUTORIAL\iMODBATCH\BMP.CRD
OUTFILE=D:\TUTORIAL\iMODBATCH\TIMESERIES.png

As a result of the above described content the following figure will be created.

pictures/h6-h71/plot_timeseries_b57f0208_1_sim_1.png