| Environments | PYTHON :: EASI :: MODELER |
| Quick links | Description :: Parameters :: Parameter descriptions :: Details :: Example |
| Back to top |
| Back to top |
tinint(fili, filo, dbvs, dbib, dboc, outarc, fldnme, surmodel, sazangl, zfilter, intertyp, inhull, pixres, datatype, nodatval)
| Name | Type | Caption | Length | Value range |
|---|---|---|---|---|
| FILI * | str | Input file name | 1 - | |
| FILO | str | Output file name | 0 - | |
| DBVS * | List[int] | Input point layer | 1 - 1 | |
| DBIB | List[int] | Input bitmap channel or layer | 0 - 1 | |
| DBOC | List[int] | Output raster channel or layer | 0 - 1 | |
| OUTARC | str | Create output arc layer | 0 - 5 | TRUE | FALSE Default: FALSE |
| FLDNME * | str | Z-value attribute field name | 1 - 64 | |
| SURMODEL | str | Surface model | 0 - 25 | Default: Weighted Average |
| SAZANGL | List[float] | Zenith and Azimuth angles | 0 - 2 | Default: 45,90 |
| ZFILTER | str | Z-value/location filter | 0 - 10 | Average | Minimum | Maximum | All Points Default: Average |
| INTERTYP | str | Interpolation type | 0 - 10 | Linear | Non-Linear Default: Linear |
| INHULL | str | Interpolate inside hull only | 0 - 5 | TRUE | FALSE Default: FALSE |
| PIXRES | List[float] | Output pixel resolution (m) | 0 - 2 | |
| DATATYPE | str | Output raster data type | 0 - 3 | 8U | 16U | 16S | 32R Default: 32R |
| NODATVAL | List[float] | NoData image value | 0 - 1 | Default: 0.0 |
| Back to top |
FILI
Specifies the name of the PCIDSK file that contains the input point layer. If the projection of the point layer is different from that of the output raster, each point will be reprojected to the raster projection before the calculation is performed.
FILO
Specifies the name of the PCIDSK image file to receive the raster layer from the point layer. If FILO is not specified, FILI will be used. If FILO exists, its projection must be the same as FILI.
If FILO is specified and does not exist, a new PCIDSK file is created. By default, the georeferencing information from FILI will be copied to the new FILO. If a pixel X/Y resolution is specified and is different from FILI, the extents of FILO will be different.
FILO optionally contains the output line layer representing the TIN.
DBVS
Specifies the vector segment that contains the Point Layer.
If the projection of the point layer is different from that of the output raster, each point will be reprojected to the raster projection before the calculation is performed
DBIB
Specifies the channel or layer that contains the bitmap mask used to restrict the region when generating the weighted average. The results will be generated inside the bitmap layer (value 1) and pixels falling outside the bitmap (value 0) will be assigned a "No Data" value.
The bitmap layer also defines the geoereferencing of the output raster, if it is used.
DBOC
Specifies the raster image channel to receive converted point layer.
If FILO exists, this parameter must be specified and must exist. If FILO does not exist, DBOC is ignored.
OUTARC
Specifies whether the output line layer representing the Triangulared Irregular Network (TIN) is sent to the output file.
If TRUE, the output arc layer is stored in a new vector segment in FILO; otherwise, no output arc layer is produced. The default value is FALSE.
FLDNME
Specifies the attribute (up to 64 characters) to be used to generate the raster.
For example:
fldnme = PixelValue | uses "PixelValue" as field name
SURMODEL
Specifies the function to use to generate the raster surface model.
For more information, see the Details section.
SAZANGL
The Zenith and Azimuth angles are used to determine the direction of the light source, when the specified surface model is Incidence Angle.
The Zenith Angle is the angle, in degrees, of the ray of light with respect to the vertical. A zenith angle of 0 degrees is in line with the vertical; an angle of 90 degrees indicates dawn or dusk. Enter a value from 0 to 90.
The Azimuth is the direction measured in degrees clockwise from North. North has an azimuth of 0 degrees; East has an azimuth of 90 degrees; South has an azimuth of 180 degrees; and West has an azimuth of 270 degrees. Enter a value from 0 to 359.
ZFILTER
Depending on the number of pixels/lines in the output raster, some pixels in the output raster may contain more than one point and, therefore, more than one value. This parameter specifies the policy for filtering these values to define a single value for each pixel.
INTERTYP
Specifies the interpolation method to use.
INHULL
If TRUE, constrains the surface interpolation to the area defined by the hull. The hull is the outer limit of the point data as defined by the TIN. For aesthetic reasons, it may be desirable to extend the interpolation beyond this limit to the edge of the new raster or bitmap; the output values produced in the area outside of the hull, however, will be unreliable.
PIXRES
Specifies the pixel resolution or size, in meters, for the output raster channel.
This parameter is mandatory if DBIB is not specified. If PIXRES is not specified, the projection info will be taken from the georef segment of FILI. The specified pixel size is determines the number of pixels and lines in the output file. A smaller pixel size results in a larger output file and increased computation time.
DATATYPE
Specifies the data type of the output channel to be created.
If FILO exists and DBOC exists, the existing datatype from that channel will be used instead of the one specified here.
NODATVAL
Specifies the NoData (background) value, of the input file.
All output pixels that did not receive a calculated value are assigned a NoData value. The NoData value must fall within the range of the output raster type.
If this parameter is not specified, the NoData value for each channel defaults to "0.0".
All areas in the input area having the specified NoData value are excluded from processing.
| Back to top |
TININT generates a surface by applying a triangulated irregular network (TIN) to the points in the data layer. When a TIN is applied, the points are joined in a network of triangles, with each point representing the vertex of a triangle. Each vertex of a triangle represents three values: X, Y, and Z. The x and y values are the two-dimensional, locational values of the points. The x-value is an attribute for the point layer; for example, elevation. The area of each resulting triangle forms a plane in the TIN from which a surface can be generated.
The value at each output raster pixel is calculated based on its position on the plane and the values of the points forming the vertices of that plane.
TININT is most appropriate for interval or ratio point data that represents a continuous phenomenon. Continuous phenomena is data that can be measured at a series of locations and is highly applicable to natural phenomena such as temperature, elevation, or rainfall.
Surface Models
Weighted average of z-value: This surface model applies a weight inversely proportional to the distance of the center of the output pixel from the three vertices of the plane.
The Weighted Average function can be used to produce a DEM. To produce a DEM, the Z-Value Field parameter must be expressed in meters.
Slope (%) / Sloper (deg): This surface model calculates the maximum slope. The slope is the change in elevation of a surface and it is expressed as a percentage of the rise over run or in degrees. A value of 0% represents a slope of 0 degrees; a value of 100% represents a slope of 45 degrees. Note that the relationship between percentage and degrees as represented here is non-linear.
The Slope function may be used to analyze precipitation runoff, identify optimal locations for skiing, or identify areas to be avoided when determining siting for new buildings and transportation routes.
Aspect: This surface model calculates the aspect. The aspect is the direction of the steepest slope with respect to North. It is expressed in degrees clockwise from North. A slope facing North has an aspect of 0 degrees; facing East, 90 degrees; facing South, 180 degrees; and facing West, 270 degrees. If it is a flat surface, meaning there is no slope, the aspect has a value of 360 degrees.
Determining the aspect is helpful in analyzing wind exposure or identifying optimal locations, for example, for cultivating crops requiring maximum southern exposure. This function can also be used to determine edge direction.
X-Derivative: This surface model calculates the slope in the East-West, or X-direction. It is expressed as a percentage of the rise over run. A value of 0% represents a slope of 0 degrees; a value of 100% represents a slope of 45 degrees. A negative value indicates a decline; a positive value indicates an incline. Note that the relationship between percentage and degrees as represented here is non-linear.
Y-Derivative: This surface model calculates the slope in the North-South, or Y-direction. It is expressed as a percentage of the rise over run. A value of 0% represents a slope of 0 degrees; a value of 100% represents a slope of 45 degrees. A negative value indicates a decline; a positive value indicates an incline. Note that the relationship between percentage and degrees as represented here is non-linear.
Incidence Angle: This surface model calculates the angle of incidence. The angle of incidence is the angle a ray of light falling on the surface makes with respect to the perpendicular, or the normal, of that surface. For purposes of this function, the light source is considered to be infinitely distant and, therefore, the rays of light are considered to be parallel. The direction of the light source is specified by the user by setting the Azimuth and Zenith angles. The Azimuth is the direction measured in degrees clockwise from North. The Zenith angle is the angle of the ray of light with respect to the vertical. The angle of incidence is expressed in degrees ranging from 0 degrees to 180 degrees. When the angle of incidence is greater than 90 degrees, that point is in shadow; this is referred to as self-shadow. The angle of incidence is 0 degrees when the light source is at a point directly over the perpendicular to the surface.
This function is useful in climate modelling. A map showing the angle of incidence may be used in conjunction with other surface analyses.
| Back to top |
The point layer in segment 32 from "irvine.pix" is converted to a raster layer in a new file called "oirvine.pix". The surface model used in the calculation is the Weighted Average and the raster is generated with the field name PixelValue. The raster channel is not generated within the hull and it is filtered with the Average filter function.
from pci.tinint import tinint
fili = "IRVINE.PIX" # input file name
filo = "OIRVINE.PIX" # will be created if it does not exist
dbvs = [32] # input vector segment (Point Layer)
dbib = [] # DBIB is not used
dboc = [1] # channel for the output raster
outarc = "TRUE" # generate the output arc layer in FILO
fldnme = "PixelValue" # use field name PixelValue
surmodel = "" # defaults to 'Weighted Average'
sazangl = [] # defaults to zenith=45,azimuth=90
zfilter = "" # defaults to Average filtering
intertyp = "" # defaults to Linear Interpolation
inhull = "" # FALSE, raster not generated within the hull
pixres = [30,30] # use a pixel resolution of 30x30
datatype = "32R" # output channel is of type 32R
nodatval = [] # defaults to 0.0
tinint( fili, filo, dbvs, dbib, dboc, outarc, fldnme, \
surmodel, sazangl, zfilter, intertyp, inhull, \
pixres, datatype, nodatval )
© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.