fmeobjects.FMERasterProperties¶

`FMERasterProperties.equals`(fmerp)	This method evaluates whether two properties have the identical value.
`FMERasterProperties.getAsAffineTransform`()	This method returns origin, spacing rotation as an affine transformation.
`FMERasterProperties.getCellOriginX`()	Get the horizontal position of the cell origin within each cell.
`FMERasterProperties.getCellOriginY`()	Get the vertical position of the cell origin within each cell.
`FMERasterProperties.getGCPCoordSys`()	Get OGC definition of the GCP coordinate system.
`FMERasterProperties.getGCPCount`()	Get the number of GCPs stored on the raster geometry.
`FMERasterProperties.getGCPs`()	Get a list of dictionaries where each dictionary contains ‘row’, ‘col’, ‘x’, ‘y’, and ‘z’ (optional).
`FMERasterProperties.getLowerLeftCornerX`()	Get the x ground coordinate value of the lower-left corner of the unrotated raster, after rotation is applied.
`FMERasterProperties.getLowerLeftCornerY`()	Get the y ground coordinate value of the lower-left y corner of the unrotated raster, after rotation is applied.
`FMERasterProperties.getLowerRightCornerX`()	Get the x ground coordinate value of the lower-right corner of the unrotated raster, after rotation is applied.
`FMERasterProperties.getLowerRightCornerY`()	Get the y ground coordinate value of the lower-right corner of the unrotated raster, after rotation is applied.
`FMERasterProperties.getMaxX`()	Get the x ground coordinate value of the right-most side of the right-most cell of the raster.
`FMERasterProperties.getMaxY`()	Get the y ground coordinate value of the top-most side of the top-most cell of the raster.
`FMERasterProperties.getMinX`()	Get the x ground coordinate value of the left-most side of the left-most cell of the raster.
`FMERasterProperties.getMinY`()	Get the y ground coordinate value of the bottom-most side of the bottom-most cell of the raster.
`FMERasterProperties.getNumCols`()	Get the number of columns in the raster.
`FMERasterProperties.getNumRows`()	Get the number of rows in the raster.
`FMERasterProperties.getOriginX`()	Get the x coordinate of the origin or the raster.
`FMERasterProperties.getOriginY`()	Get the y coordinate of the origin or the raster.
`FMERasterProperties.getRotationX`()	Get the rotation angle of the raster in radians from x axis.
`FMERasterProperties.getRotationY`()	Get the rotation angle of the raster in radians from y axis.
`FMERasterProperties.getSpacingX`()	Get fixed distance in the x dimension between each pixel in the raster.
`FMERasterProperties.getSpacingY`()	Get fixed distance in the y dimension between each pixel in the raster.
`FMERasterProperties.getUpperLeftCornerX`()	Get the ground x coordinate value of the upper-left corner of the unrotated raster, after rotation is applied.
`FMERasterProperties.getUpperLeftCornerY`()	Get the ground y coordinate value of the upper-left corner of the unrotated raster, after rotation is applied.
`FMERasterProperties.getUpperRightCornerX`()	Get the x coordinate value of the upper-right corner of the unrotated raster, after rotation is applied.
`FMERasterProperties.getUpperRightCornerY`()	Get the y coordinate value of the upper-right corner of the unrotated raster, after rotation is applied.
`FMERasterProperties.hasBeenModified`()	This method evaluates whether the raster properties have been modified from their baseline state.
`FMERasterProperties.setAsAffineTransform`(…)	This method sets origin, spacing, and rotation as an affine transformation.
`FMERasterProperties.setCellOriginX`(xCellOrigin)	This method sets horizontal position of the cell origin within each cell.
`FMERasterProperties.setCellOriginY`(yCellOrigin)	This method sets vertical position of the cell origin within each cell.
`FMERasterProperties.setGCPCoordSys`(gcpCoordSys)	This method sets GCP coordinate system.
`FMERasterProperties.setGCPs`(dataList, coordSys)	This method sets a list of GCPs on the properties.
`FMERasterProperties.setModified`(modified)	This method sets whether raster properties have been modified from baseline state.
`FMERasterProperties.setNumCols`(numCols)	This method sets number of columns of the raster.
`FMERasterProperties.setNumRows`(numRows)	This method sets number of rows of the raster.
`FMERasterProperties.setOriginX`(xOrigin)	This method sets x value of the upper left corner of the raster in ground coordinates.
`FMERasterProperties.setOriginY`(yOrigin)	This method sets y value of the upper left corner of the raster in ground coordinates.
`FMERasterProperties.setRotation`(rotation)	This method sets the rotation angle of the raster in radians as measured in a CCW direction.
`FMERasterProperties.setRotationX`	setRotationY(yRotation)
`FMERasterProperties.setRotationY`(yRotation)	setRotationX(xRotation)
`FMERasterProperties.setSpacingX`(xSpacing)	This method sets the x spacing (cell size) of the raster.
`FMERasterProperties.setSpacingY`(ySpacing)	This method sets the y spacing (cell size) of the raster

class FMERasterProperties¶

Bases: object

__getObject__(args)

FME Raster Properties Class

Create an instance of a FMERasterProperties object.

init(numRows, numCols, xSpacing, ySpacing, xCellOrigin, yCellOrigin, xOrigin, yOrigin, xRotation, yRotation)

Creates a raster property with the given properties.

Parameters:	numRows (int) – Number of Rows. Must be positive integer. numCols (int) – Number of Columns. Must be positive integer. xSpacing (float) – Space between columns. Must be positive float. ySpacing (float) – Space between rows. Must be positive float. xCellOrigin (float) – Cell origin within a cell: X coordinate. Must be between 0 to 1, inclusive. yCellOrigin (float) – Cell origin within a cell: Y coodinate. Must be between 0 to 1, inclusive. xOrigin (float) – x value of the upper left corner of the raster. yOrigin (float) – y value of the upper left corner of the raster. xRotation (float) – Rotation angle of the raster in radians as measured in a CCW direction from the positive x axis. yRotation (float) – Rotation angle of the raster in radians as measured in a CCW direction from the negative y axis.
Return type:	FMERasterProperties
Returns:	An instance of a `RasterProperties` object.

init(numRows, numCols, xCellOrigin, yCellOrigin, transform)

Creates a raster properties object from an affine transformation.

Parameters:	numRows (int) – Number of Rows. Must be positive integer. numCols (int) – Number of Columns. Must be positive integer. xCellOrigin (float) – Cell origin within a cell: X coordinate. Must be between 0 to 1, inclusive. yCellOrigin (float) – Cell origin within a cell: Y coodinate. Must be between 0 to 1, inclusive. transform (list) – List containing 6 Coefficients. A B C D E F in the affine transformation x’ = Ax + By + C, y’ = Dx + Ey + F.
Return type:	FMERasterProperties
Returns:	An instance of a `RasterProperties` object.

init(rasterProperties)

Create a copy of the passed in raster properties object.

Parameters:	rasterProperties (FMERasterProperties) – The rasterProperties object to create a copy of.
Return type:	FMERasterProperties
Returns:	An instance of a `RasterProperties` object.

__init__¶: Initialize self. See help(type(self)) for accurate signature.

equals(fmerp)¶

This method evaluates whether two properties have the identical value.

Parameters:	fmerp (FMERasterProperties) – The raster property to compare to.
Return type:	bool
Returns:	`True` if the two properties had the same value.

getAsAffineTransform()¶

This method returns origin, spacing rotation as an affine transformation.

Return type:	list[float]
Returns:	A list containing 6 values that represents the coefficients A B C D E F in the affine transformation: x’ = Ax + By + C, y’ = Dx + Ey + F .

getCellOriginX()¶

Get the horizontal position of the cell origin within each cell.

Return type:	float
Returns:	The horizontal position of the cell origin.

getCellOriginY()¶

Get the vertical position of the cell origin within each cell.

Return type:	float
Returns:	The vertical position of the cell origin.

getGCPCoordSys()¶

Get OGC definition of the GCP coordinate system.

Return type:	str
Returns:	OGC definition of the GCP coordinate system.

getGCPCount()¶

Get the number of GCPs stored on the raster geometry.

Return type:	int
Returns:	The number of GCPs stored on the raster geometry.

getGCPs()¶

Get a list of dictionaries where each dictionary contains ‘row’, ‘col’, ‘x’, ‘y’, and ‘z’ (optional).

When ‘z’ is not set, value of ‘z’ will be set to 0.

Return type:	list of dictionaries containing keys (`string`) and values (`float`) or `None`.
Returns:	Row and col in raster space, and xyz location in model space. `None` will be returned if raster does not contain GCPs.

getLowerLeftCornerX()¶

Get the x ground coordinate value of the lower-left corner of the unrotated raster, after rotation is applied.

Return type:	float
Returns:	Ground coordinate value of the lower-left corner of the unrotated raster, after rotation is applied. When the raster is not rotated, this will be equal to the value returned by `getMinX()`.

getLowerLeftCornerY()¶

Get the y ground coordinate value of the lower-left y corner of the unrotated raster, after rotation is applied.

Return type:	float
Returns:	Ground coordinate value of the lower-left corner of the unrotated raster, after rotation is applied. When the raster is not rotated, this will be equal to the value returned by `getMinY()`.

getLowerRightCornerX()¶

Get the x ground coordinate value of the lower-right corner of the unrotated raster, after rotation is applied.

Return type:	float
Returns:	Ground coordinate value of the lower-right corner of the unrotated raster, after rotation is applied. When the raster is not rotated, this will be equal to the value returned by `getMaxX()`.

getLowerRightCornerY()¶

Get the y ground coordinate value of the lower-right corner of the unrotated raster, after rotation is applied.

Return type:	float
Returns:	Ground coordinate value of the lower-right corner of the unrotated raster, after rotation is applied. When the raster is not rotated, this will be equal to the value returned by `getMinY()`.

getMaxX()¶

Get the x ground coordinate value of the right-most side of the right-most cell of the raster.

Return type:	float
Returns:	Ground coordinate value of the right-most side of the right-most cell of the raster.

getMaxY()¶

Get the y ground coordinate value of the top-most side of the top-most cell of the raster.

Return type:	float
Returns:	Ground coordinate value of the top-most side of the right-most cell of the raster.

getMinX()¶

Get the x ground coordinate value of the left-most side of the left-most cell of the raster.

Return type:	float
Returns:	Ground coordinate value of the left-most side of the left-most cell of the raster.

getMinY()¶

Get the y ground coordinate value of the bottom-most side of the bottom-most cell of the raster.

Return type:	float
Returns:	Ground coordinate value of the bottom-most side of the bottom-most cell of the raster.

getNumCols()¶

Get the number of columns in the raster.

Return type:	int
Returns:	The number of columns.

getNumRows()¶

Get the number of rows in the raster.

Return type:	int
Returns:	The number of rows.

getOriginX()¶

Get the x coordinate of the origin or the raster.

Return type:	float
Returns:	X coordinate of the raster. It’s the ground coordinate value of the top-left cell in the top-left corner of the raster.

getOriginY()¶

Get the y coordinate of the origin or the raster.

Return type:	float
Returns:	Y coordinate of the raster. It’s the ground coordinate value of the top-left cell in the top-left corner of the raster.

getRotationX()¶

Get the rotation angle of the raster in radians from x axis.

Return type:	float
Returns:	Rotation angle of the raster in radians. Measured in a CCW direction from the positive x axis.

getRotationY()¶

Get the rotation angle of the raster in radians from y axis.

Return type:	float
Returns:	Rotation angle of the raster in radians. Measured in a CCW direction from the negative y axis.

getSpacingX()¶

Get fixed distance in the x dimension between each pixel in the raster.

Return type:	float
Returns:	x spacing (cell size) of the raster.

getSpacingY()¶

Get fixed distance in the y dimension between each pixel in the raster.

Return type:	float
Returns:	y spacing (cell size) of the raster.

getUpperLeftCornerX()¶

Get the ground x coordinate value of the upper-left corner of the unrotated raster, after rotation is applied.

Return type:	float
Returns:	Ground coordinate value of the upper-left corner of the unrotated raster, after rotation is applied. When the raster is not rotated, this will be equal to the value returned by `getMinX()`.

getUpperLeftCornerY()¶

Get the ground y coordinate value of the upper-left corner of the unrotated raster, after rotation is applied.

Return type:	float
Returns:	Ground coordinate value of the upper-left corner of the unrotated raster, after rotation is applied. When the raster is not rotated, this will be equal to the value returned by `getMaxY()`.

getUpperRightCornerX()¶

Get the x coordinate value of the upper-right corner of the unrotated raster, after rotation is applied.

Return type:	float
Returns:	Ground coordinate value of the upper-right corner of the unrotated raster, after rotation is applied. When the raster is not rotated, this will be equal to the value returned by `getMaxX()`.

getUpperRightCornerY()¶

Get the y coordinate value of the upper-right corner of the unrotated raster, after rotation is applied.

Return type:	float
Returns:	Ground coordinate value of the upper-right corner of the unrotated raster, after rotation is applied. When the raster is not rotated, this will be equal to the value returned by `getMaxY()`.

hasBeenModified()¶

This method evaluates whether the raster properties have been modified from their baseline state.

Return type:	bool
Returns:	`True` if the raster properties have been modified.

setAsAffineTransform(affineTransform)¶

This method sets origin, spacing, and rotation as an affine transformation.

Parameters:	affineTransform (list[float]) – List containing 6 Coefficients. A B C D E F in the affine transformation x’ = Ax + By + C, y’ = Dx + Ey + F .
Return type:	None

setCellOriginX(xCellOrigin)¶

This method sets horizontal position of the cell origin within each cell.

Once cell origin is specified, it applies to all cells.

Parameters:	xCellOrigin (float) – horizontal position of the cell origin within each cell. Cell origin is a normalized value so the value should be in the range of 0.0 to 1.0 inclusive. For example, cell with origin set to (0.5, 0.5) will have its origin at the center.
Return type:	None
Raises:	FMEException – An exception is raised if an error occurred.

setCellOriginY(yCellOrigin)¶

This method sets vertical position of the cell origin within each cell.

Once cell origin is specified, it applies to all cells.

Parameters:	yCellOrigin (float) – vertical position of the cell origin within each cell. Cell origin is a normalized value so the value should be in the range of 0.0 to 1.0 inclusive. For example, cell with origin set to (0.5, 0.5) will have its origin at the center.
Return type:	None
Raises:	FMEException – An exception is raised if an error occurred.

setGCPCoordSys(gcpCoordSys)¶

This method sets GCP coordinate system.

Parameters:	gcpCoordSys (str) – GCP coordinate system.
Return type:	None

setGCPs(dataList, coordSys)¶

This method sets a list of GCPs on the properties.

Parameters:	dataList (list[dict]) – A list of dictionaries where each dictionary contains row, col, x, y, and z (optional). For example, to set all of the keys, a list should look like as follows: [{‘row’:1, ‘col’:2, ‘x’:3, ‘y’:4, ‘z’:5}]. To set row, col, x, and y only, do not specify ‘z’ in the list: [{‘row’:1, ‘col’:2, ‘x’:3, ‘y’:4}]. If z is not specified, it will be set to 0. coordSys (str) – GCP coordinate system.
Return type:	None
Raises:	FMEException – An exception is raised if an error occurred.

setModified(modified)¶

This method sets whether raster properties have been modified from baseline state.

Note that hasBeenModified() is initially set to False.

Parameters:	modified (bool) – set `True` when properties is altered.
Return type:	None

setNumCols(numCols)¶

This method sets number of columns of the raster.

Parameters:	numCols (int) – Number of columns of the raster. Number must be a positive integer.
Return type:	None
Raises:	FMEException – An exception is raised if an error occurred.

setNumRows(numRows)¶

This method sets number of rows of the raster.

Parameters:	numRows (int) – Number of rows of the raster. Number must be a positive integer.
Return type:	None
Raises:	FMEException – An exception is raised if an error occurred.

setOriginX(xOrigin)¶

This method sets x value of the upper left corner of the raster in ground coordinates.

Parameters:	xOrigin (float) – x value of the upper left corner of the raster.
Return type:	None

setOriginY(yOrigin)¶

This method sets y value of the upper left corner of the raster in ground coordinates.

Parameters:	yOrigin (float) – y value of the upper left corner of the raster.
Return type:	None

setRotation(rotation)¶

This method sets the rotation angle of the raster in radians as measured in a CCW direction.

Parameters:	rotation (float) – Rotation angle of the raster in radians as measured in a CCW direction.
Return type:	None

setRotationX()¶

setRotationY(yRotation)

setRotationX(xRotation)

This method sets the rotation angle of the raster in radians.

Parameters:	xRotation (float) – Rotation angle of the raster in radians as measured in a CCW direction from the positive x axis.
Return type:	None

setRotationY(yRotation)¶

setRotationX(xRotation)

This method sets the rotation angle of the raster in radians.

Parameters:	yRotation (float) – Rotation angle of the raster in radians as measured in a CCW direction from the negative y axis.
Return type:	None

setSpacingX(xSpacing)¶

This method sets the x spacing (cell size) of the raster.

Parameters:	xSpacing (float) – Fixed distance in the x dimension between each pixel in the raster. Number must be positive value.
Return type:	None
Raises:	FMEException – An exception is raised if an error occurred.

setSpacingY(ySpacing)¶

This method sets the y spacing (cell size) of the raster

Parameters:	ySpacing (float) – Fixed distance in the y dimension between each pixel in the raster. Number must be positive value.
Return type:	None
Raises:	FMEException – An exception is raised if an error occurred.