Appendices

ILWIS commands

By typing an ILWIS command on the command line of the Main window, usually a dialog box is opened. Generally, some user-interaction is required before the command can be carried out, i.e. you may have to supply additional information in the dialog box, and click the OK button in the dialog box.

You can for instance obtain dialog boxes to display objects, edit objects, open the properties of objects, or create objects. You can also obtain the dialog box of an operation.

This topic contains the following sections:

Open, edit, or create an object or open properties of an object.

Commands on the command line of a table window.

Open the dialog box of an operation.
Data management: delete, etc.
Other commands and expressions, use of ? ! !! ; etc.

Tips:

Commands typed on the command line are not case sensitive.
When using long object names, see also topic How to use long object names.
For syntax to perform operations via the command line in the Main window, see Appendices : ILWIS expressions;
For additional script syntax to perform table calculations via the command line in the Main window and to automatically perform tasks which are not pure calculations or operations (without any any user-interaction), see Appendices : ILWIS Script Language (syntax).

Note:

The commands described below:

have effect when typed interactively on the command line;
have no effect when used in scripts;
have effect when using ILWIS as a DDE server (advanced);
the commands of the table window commands section however cannot be used with DDE.

1. Open, edit, create, or open properties

Several commands can be typed on the command line of the Main window to open, edit, or open the properties of an object. To open an object, it is generally faster though to double-click an object in the Catalog. To edit an object, open the properties of an object, open an object as a table or to create objects you can use context-sensitive menu in the Catalog. For more information, see How to use the Catalog.

To open or edit an object or to open the properties of an object:

Open, Show, Map, Pol, Seg, Pnt, Tbl, Mpl, View
	The commands above open an Open dialog box in which you can select the object you wish to display.
Edit	Opens the Edit Object dialog box in which you can select the object you wish to edit.
Prop	Opens the View Properties of dialog box in which you can select the object which properties you wish to view.

To directly open or edit an object or to open the object properties:

When an Open, Show, Edit or Prop command is followed by an object name including the object's extension, then the object will be directly show, directly opened in an editor, or the object's Properties sheet will be directly opened. The dialog boxes described above in which an object needs to be selected are thus skipped. To close a shown object, an editor or a Properties sheet however, user-interaction is still required.

Open objname.ext	Opens object objname.ext immediately where objname is the name of the object and .ext is the object's extension. Opens a Display Options dialog box in case of maps, opens a table window displaying the table, the two-dimensional table or the histogram, or shows the object otherwise immediately; for details, see next paragraphs. Tip: To skip a Display Options dialog box, see ILWIS script language (syntax), where you can use the parameter -noask.
Show objname.ext	Same as Open objname.ext.
Edit objname.ext	Starts the appropriate editor or opens a dialog box in which you can edit the object.
Prop objname.ext	Show the Property sheet of the object. For more information, see Basic concepts : properties of objects.

Other possibilities to open specific objects (generally no extensions required):

Map Rasmapname	Opens the Display Options dialog box for the raster map.
Pol Polmapname	Opens the Display Options - Polygon Map dialog box.
Seg Segmapname	Opens the Display Options - Segment Map dialog box.
Pnt Pointmapname	Opens the Display Options- Point Map dialog box.
Tbl Tablename	Displays the table in a table window.
Mpl MapListname	The Display Options - Map List as Color Composite dialog box is opened. If the raster maps in the map list are not value maps, an error message will appear.
View MapViewname	Displays the map view in a map window.
Layout	Opens a new empty layout in the Layout editor.
Layout MapViewname.mpv
	Create a new (untitled) layout and add map view MapViewname to it. The extension .MPV is required. First a small dialog box will appear asking for the scale on which the map view should be displayed. Then, the Layout editor will be opened.
Layout Layoutname.ilo	Opens the existing layout Layoutname.ilo in the Layout editor. The extension .ILO is required.
Dom Domname	Opens the Domain Class/ID editor in case a of domain class, ID, Group or Picture, or opens the Edit Domain Value dialog box in case of an editable value domain.
Rpr Reprname	Opens the Representation Class editor in case of a repesentation Class or Picture, or opens the representation Value/Gradual editor in case of an editable representation Value or Gradual.

To show objects as tables (advanced):

ShowAsTbl	Opens the Show As Table dialog box which allows you to select any object that can be opened as a table. For more information, see also How to open objects as a table.
OpenAsTbl	Alias for ShowAsTbl.
ShowAsTbl pntmap.mpp	Opens the point map pntmap immediately as a table.
ShowAsTbl domain.dom	Opens the domain domain immediately as a table.
ShowAsTbl repres.rpr	Opens the representation repres immediately as a table.
ShowAsTbl georef.grf	Opens the georeference tiepoints georef immediately as a table.

To show internal domains and representations (advanced):

ShowAsDom objname.ext	Opens the internal domain of object objname.ext.
OpenAsDom	Alias for ShowAsDom.
ShowAsRpr objname.ext	Opens the internal representation of object objname.ext.
OpenAsRpr	Alias for ShowAsRpr.

To create an ILWIS object:

Use the Create command followed by an object abbreviation:

Create map	Opens the Create Raster Map dialog box.
Create seg	Opens the Create Segment Map dialog box.
Create pnt	Opens the Create Point Map dialog box.
Create tbl	Opens the Create Table dialog box.
Create mpl	Opens the Create Map List dialog box.
Create ioc	Opens the Create Object Collection dialog box.
Create ilo \| Create lay \| Create layout
	Opens a new empty layout in the layout editor.
Create dom	Opens the Create Domain dialog box.
Create rpr	Opens the Create Representation dialog box.
Create grf	Opens the Create Georeference dialog box.
Create csy	Opens the Create Coordinate System dialog box.
Create sms	Opens the Create Sample Set dialog box.
Create tb2	Opens the Create Two-Dimensional Table dialog box.
Create fil	Opens the Create Filter dialog box.
Create fun \| Create function
	Opens the Create Function dialog box.
Create isl \| Create script
	Opens the Script editor.
Create dir	Creates a new directory: first a small dialog box appears in which you can specify the name of the new directory; then, the new directory will be shown in a new Catalog.

To open the pixel info window:

Pixelinfo

Opens a new empty pixel info window. Tip: To directly add maps, map lists and/or coordinate systems to the pixel info window, see Appendices : ILWIS Script Language.

To run a script:

Run scriptname var1 var2
	Runs script scriptname with variables var1 and var2. Variables are optional. By using the Run command, you can continue working with ILWIS while the script is running. For more information, see How to run scripts.

To obtain help:

Help	Opens the ILWIS.CHM Help file on the page of the current window. Same as using the F1 key in a window: Help on this window.

Commands on the command line of a table window:

Sorton	Opens the Sort dialog box.
Sorton col	Sorts the table in ascending order on column col.
Sorton col [-sortorder=ascending\|descending]
	Sorts the table on column col; whether the table is sorted in ascending or descending order depends on the value specified for the parameter -sortorder= which should be followed either by ascending or descending.
Colman	Opens the Column Management dialog box.
UpdateAllColumns	Recalculates all dependent columns which are not up-to-date anymore; all columns are thus made up-to-date again.
Statistics	Opens the Column Statistics dialog box.
Join	Opens the first page of the Join Column wizard.
Aggregate	Opens the Aggregate Column dialog box.
Cumulative	Opens the Cumulative Column dialog box.
LeastSquares	Opens the Least Squares Fit dialog box.
SemiVariogram	Opens the Semi-variogram column dialog box.
Slicing	Opens the Column Slicing dialog box.
AddRecord	Adds a single record to a table which has domain None.
AddRecord nr	Adds a certain number nr of records to a table which has domain None.
Graph	Opens the dialog box to obtain a Graph from columns.
RoseDiagram	Opens the dialog box to obtain a Rose diagram.
ConfMat	Opens the dialog box to obtain a Confusion Matrix.
AddInfo	Opens the additional info of the table. Handy when inspecting a histogram, or when a georeference is opened as a table. Additional Info is also accessible through in the properties sheet of a histogram, a georeference, etc.
Prop	Opens the Table Properties sheet.

2. Open the dialog box of an operation

To obtain the dialog box of an ILWIS operation, type one of the following commands or aliases.

To obtain the dialog box of an operation, you can also double-click the operation in the Operation-tree or the Operation-list, or select it from the Operations menu.

Any operation which is performed through a dialog box will result in a dependent output object.

Operation	command	alias(es)
Visualization
Show Map	Show	Open, Map, CopyMap
Show Table	Tbl	TabCalc
Show MapList
as Color Composite	ColorComp
as Slide Show	SlideShow	Film
Display 3D	Display3D
Apply 3D	Apply3D
Show Stereo Pair
as Anaglyph	Anaglyph
with Stereoscope	Stereoscope
Raster Operations
Map Calculate	MapCalc	MCalc
Attribute Map	AttribRas
Cross	Cross
Aggregate Map	Aggregate
Distance	Distance
Iteration	MapIter	Iter, Iterp
Area Numbering	AreaNumb
Sub Map	SubRas	SubMap
Glue Maps	Glue	GlueRas
Mirror Rotate	Mirror	MirrorRotate
SMCE	SMCE

Image Processing
Filter	Filter	FiltrMap
Stretch	Stretch
Slicing	Slicing	Clfy
Color Separation	ColorSep
Color Composite	ColorCmp
Cluster	Cluster
Sample	Sample	Smpl
Classify	Classify
Resample	Resample	GeoCorr
Epipolar Stereo Pair	MakeStereoPair
Stereo Pair from DTM	MakeSTPfromDTM

Statistics
Histogram	Histogram	Histgram
Raster
Autocorrelation	Autocorr
Variogram Surface	VariogramSurface
MapList
Principal Components	PrincCmp
Factor Analysis	FactAnal
Variance Covariance	MatVarCov
Correlation Matrix	MatCorr
Polygons
Neighbour Polygons	HistNbPol
Segments
Direction Histogram	HistSegDir	LinAnal
Points
Spatial correlation	SpatCorr
Variogram Surface	VariogramSurface
Cross Variogram	CrossVariogram
Pattern Analysis	PattAnal

Interpolation
Densify map	DensRas	Densify, InterpolRas
Kriging From Raster	KrigingRas
Contour Interpolation	InterpolSeg	Interpol
Point Interpolation
Nearest Point	NearestPnt
Moving Average	MovAverage
Trend Surface	TrendSurface
Moving Surface	MovSurface	Gridding
Kriging	Kriging
Anisotropic Kriging	AnisotrKriging
Universal Kriging	UnivKriging
CoKriging	CoKriging

Vector Operations
Unique ID	UniqueID
Polygons
Attribute Map	AttribPol
Mask Polygons	MaskPol
Assign Labels	LabelPol
Transform Polygons	TransfPol
ID Grid Map	IDGrid
Segments
Attribute Map	AttribSeg
Mask Segments	MaskSeg	CopySeg
Assign Labels	LabelSeg
Sub Map	SubSeg
Glue Maps	GlueSeg
Densify Coordinates	DensSeg
Transform Segments	TransfSeg
Tunneling	TunnelSeg
Points
Attribute Map	AttribPnt
Mask Points	MaskPnt
SubMap	SubPnt
Glue Maps	GluePnt
Transform Points	TransfPnt
Coordinates
Transform Coordinates	Transform
Find Datum Parameters	FindDatumParms

Rasterize
Polygon to Raster	PolRas
Segment to Raster	SegRas
Segment Density	SegDensity	Ld
Point to Raster	PntRas
Point Density	PntDensity

Vectorize
Raster to Polygon	RasPol	RasVec
Raster to Segment	RasSeg
Raster to Point	RasPnt
Polygon to Segment	PolSeg
Polygon to Point	PolPnt
Segment to Polygon	SegPol	Polygonize
Segment to Point	SegPnt

Table Operations:
Transpose Table	Transpose
Change Domain	TblChDom
Table to PointMap	TblPnt
Glue tables	TblGlue

DEM-Hydro Processing:
Flow Determination
Fill Sinks	FillSinks
Flow Direction	FlowDirection
Flow Accumulation	FlowAccumulation
Flow Modification
DEM Optimization	DemOptimization
Topological Optimization	TopologicalOptimization
Variable Threshold Computation	VariableThresholdComputation
Network and Catchment Extraction
Drainage Network Extraction	DrainageNetworkExtraction
Drainage Network Ordering	DrainageNetworkOrdering
Catchment Extraction	CatchmentExtraction
Catchment Merge	CatchmentMerge
Compound Parameter Extraction
Overland Flow Length	OverlandFlowLength
Statistical Parameter Extraction
Horton Statistics	HortonPlots

Import/Export commands:

Import	Opens the Import dialog box.
Import -generalraster
	Opens the Import (General Raster) dialog box while for Import Format is selected: Use General Raster Import.
Import -tablewizard
	Opens the first page of the Import Table wizard.
Export	Opens the Export dialog box.

3. Data Management

Below, you may read Folder where it reads directory.

Del	Opens the Select object to be deleted dialog box.
Del objname.ext	Deletes object objname.ext where objname is the object name and .ext the object's extension.
dir	Refreshes the current Catalog. You can also use the F5 key on the keyboard.
dir query	In the current Catalog, only show the objects that are the result of the query query. For more information, see Customize Catalog, Query, section Query syntax.
cd\	Change the current working directory to the root of the current drive and list the objects in the current Catalog.
cd\dir	Change the current working directory to the (sub)directory dir and list the objects in that directory in the current Catalog.
cd..	Change the current working directory to one directory up (parent directory) and list the objects in that directory in the current Catalog.
cd ..	Change the current working directory to one directory up (parent directory) and list the objects in that directory in the current Catalog.
cd subdir	Change the current working directory to subdirectory subdir and list the objects in that directory in the current Catalog.
md	Gives a dialog box to create a new subdirectory in the current working directory; specify a new directory name, then a new Catalog is opened for the new directory.

md newdir	Creates a new subdirectory newdir in the current working directory, and opens a new Catalog for the new directory.
mkdir newdir	Creates a new subdirectory newdir in the current working directory, and opens a new Catalog for the new directory.
rd	Gives a dialog box to remove an empty subdirectory from the current working directory; specify the name of an empty subdirectory.
rd subdir	Removes the empty subdirectory subdir from the current working directory.
rmdir subdir	Removes the empty subdirectory subdir from the current working directory.
a:	Sets the current working directory to the specified drive.
exit	Closes ILWIS.

Tips:

To work with long directory names, enclose the dir, subdir or newdir parameter in single quotes. See also How to use long object names.
For other data management syntax, see also Appendices : ILWIS script language (syntax), section Data management.

Other commands and expressions

?expression	Pocket line calculator, performs calculations with constant values and/or MapCalc/TabCalc functions.

!command !command optional_parameter(s)
	Starts any Windows application, a batch file, etc. and will wait until the application has finished, i.e. ILWIS cannot be used until the external application has been closed again. Using !command with optional parameters may come in handy when you wish to adapt the Operations menu, the Operation-tree and the Operation-list. For more information, see How to customize the Operation-tree, the Operation-list and the Operations menu. Type the command directly after the exclamation mark (no spaces allowed). Programs with the following extensions can always be started: .exe, .com, .bat. You can also use Windows shortcuts (.lnk) to Windows applications, provided that the shortcut points to the correct location of the application. Furthermore, files of a registered file type can be opened with the application for which the file type has been registered (Open command). Examples of possible registered file types on your computer may be: .doc, .txt, .pdf, .xls, .ppt, .pps, .gif, .bmp, etc. If no extension is specified, .exe is assumed. Full paths and relative paths (relative to the currently active folder/currently active Catalog) may be used. If no path is specified for a program (.exe, .com, .bat), the following locations will be searched: the currently active ILWIS working folder/Catalog, the ILWIS folder, the Windows folder, the Windows\System folder, and the folders specified in the PATH environment variable. If no path is specified for a shortcut (.lnk) or for other files (e.g. .doc, .xls, .gif etc.), only the currently active ILWIS working folder, i.e. the currently active Catalog, will be searched. Long file names (e.g. programs, paths or file names containing spaces) must be quoted within single quotes, including possible extensions. Optionally, one or more parameters may be passed, separated by spaces. Parameters that contain spaces themselves, must again be quoted within single quotes, including possible extensions. Examples: to start NotePad, type: !NotePad To start Notepad via a shortcut to Notepad, when the shortcut is located in D:\My Folder, type: !!'D:\My Folder\shortcut to notepad.exe.lnk' To open a Word document called Document of Interest that is located in D:\My Documents, with the program that by default opens such files (i.e. Word), type: !'D:\My Documents\Document of Interest.doc' to start a program called My Program.exe that is located in C:\Program Files\Any Folder\, type: !'C:\Program Files\Any Folder\My Program.exe' to start a program called My Program.exe located in C:\Program Files\Any Folder\, and to pass two parameters for this program, type: !'C:\Program Files\Any Folder\My Program.exe' 'D:\this file.gif' 'D:\other file.tif'

!!command !!command optional_parameter(s)
	Same as !command, but enables a continuation of ILWIS while the external application is running. Using !!command with optional parameters may come in handy when you wish to adapt the Operations menu, the Operation-tree and the Operation-list. For more information, see How to customize the Operation-tree, the Operation-list and the Operations menu.

Script expression	Executes the expression as if running a script. By using the Script command followed by any expression that is allowed in a script (see ILWIS script language), you cannot continue working with ILWIS while the expression is executed.

expression;	Same as Script expression.