fmeobjects.FMEBandProperties¶

FMEBandProperties.equals (bandPropertyObj) |
Evaluates whether two band properties are identical. |
FMEBandProperties.getBitDepth () |
Returns bit depth of the band. |
FMEBandProperties.getInterpretation () |
Returns the interpretation of the band. |
FMEBandProperties.getName () |
Returns the name of the band. |
FMEBandProperties.getNumTileCols () |
Returns the number of columns in the tile size of the band. |
FMEBandProperties.getNumTileRows () |
Returns the number of rows in the tile size of the band. |
FMEBandProperties.getTileType () |
Returns tile type representing the type of data access supported by this band. |
FMEBandProperties.hasBeenModified () |
Evaluates whether the band properties have been modified from their baseline state. |
FMEBandProperties.setInterpretation (…) |
Sets the interpretation of the band. |
FMEBandProperties.setModified (modified) |
Sets whether band properties have been modified from baseline state. |
FMEBandProperties.setName (name) |
Sets name of the band. |
FMEBandProperties.setNumTileCols (numCols) |
Sets the number of columns per tile in the raster |
FMEBandProperties.setNumTileRows (numRows) |
Sets the number of rows per tile in the raster. |
FMEBandProperties.setTileType (tileType) |
Sets the tile type that can most efficiently support data access. |
-
class
FMEBandProperties
¶ Bases:
object
FME Band Properties Class
Create an instance of a
FMEBandProperties
object.init(nameString, interpretation, tileType, numTileRows, numTileColumns)
Creates a band property with the given properties.
Parameters: - nameString (string) – Name of the band.
- interpretation (int) –
Interpretation of a band. Choose one of:
FME_INTERPRETATION_NULL
FME_INTERPRETATION_REAL64
FME_INTERPRETATION_REAL32
FME_INTERPRETATION_UINT64
FME_INTERPRETATION_INT64
FME_INTERPRETATION_UINT32
FME_INTERPRETATION_INT32
FME_INTERPRETATION_UINT16
FME_INTERPRETATION_INT16
FME_INTERPRETATION_UINT8
FME_INTERPRETATION_INT8
FME_INTERPRETATION_GRAY8
FME_INTERPRETATION_GRAY16
FME_INTERPRETATION_RED8
FME_INTERPRETATION_RED16
FME_INTERPRETATION_GREEN8
FME_INTERPRETATION_GREEN16
FME_INTERPRETATION_BLUE8
FME_INTERPRETATION_BLUE16
FME_INTERPRETATION_ALPHA8
FME_INTERPRETATION_ALPHA16
- tileType (int) – Tile type that can most efficiently support data access. Possible values:
FME_TILE_TYPE_FIXED
: Tile requests made to a band must be equal to the band’s tile size.FME_TILE_TYPE_FIXED_MULTIPLE
: Tile requests made to a band must be a multiple of the band’s tile size.FME_TILE_TYPE_FLEXIBLE
: The band tile size is a suggestion only, and the band can handle any arbitrary tile size.
Parameters: - numTileRows – Number of rows per tile in the raster.
- numTileColumns – Number of columns per tile in the raster.
Return type: Returns: An instance of a BandProperties object.
init(bandProperties)
Create a copy of the passed in bandProperties object.
Parameters: bandProperties (FMEBandProperties) – The bandProperties object to create a copy of. Return type: FMEBandProperties Returns: An instance of a BandProperties object. -
__init__
¶ Initialize self. See help(type(self)) for accurate signature.
-
equals
(bandPropertyObj)¶ Evaluates whether two band properties are identical.
Parameters: bandPropertyObj (FMEBandProperties) – The band property to compare to. Return type: bool Returns: True
if the two properties have the same value.
-
getInterpretation
()¶ Returns the interpretation of the band.
Returns one of:
FME_INTERPRETATION_NULL
FME_INTERPRETATION_REAL64
FME_INTERPRETATION_REAL32
FME_INTERPRETATION_UINT64
FME_INTERPRETATION_INT64
FME_INTERPRETATION_UINT32
FME_INTERPRETATION_INT32
FME_INTERPRETATION_UINT16
FME_INTERPRETATION_INT16
FME_INTERPRETATION_UINT8
FME_INTERPRETATION_INT8
FME_INTERPRETATION_GRAY8
FME_INTERPRETATION_GRAY16
FME_INTERPRETATION_RED8
FME_INTERPRETATION_RED16
FME_INTERPRETATION_GREEN8
FME_INTERPRETATION_GREEN16
FME_INTERPRETATION_BLUE8
FME_INTERPRETATION_BLUE16
FME_INTERPRETATION_ALPHA8
FME_INTERPRETATION_ALPHA16
Return type: int Returns: The interpretation of the band.
-
getName
()¶ Returns the name of the band.
Return type: str or None Returns: Name of the band or None
if name does not exist.
-
getNumTileCols
()¶ Returns the number of columns in the tile size of the band. That is, this represents the most efficient tile size for data access. Note that a band can return data for any tile size (i.e.
FMEBand.getTile
will accept any tile), but using a tile with this size may have better performance or lower memory usage.Return type: int Returns: The number of columns per tile.
-
getNumTileRows
()¶ Returns the number of rows in the tile size of the band. That is, this represents the most efficient tile size for data access. Note that a band can return data for any tile size (i.e.
FMEBand.getTile
will accept any tile), but using a tile with this size may have better performance or lower memory usage.Return type: int Returns: The number of rows per tile.
-
getTileType
()¶ Returns tile type representing the type of data access supported by this band. Possible values:
FME_TILE_TYPE_FIXED
: Tile requests made to a band must be equal to the band’s tile size.FME_TILE_TYPE_FIXED_MULTIPLE
: Tile requests made to a band must be a multiple of the band’s tile size.FME_TILE_TYPE_FLEXIBLE
: The band tile size is a suggestion only, and the band can handle any arbitrary tile size. WhengetTileType()
returnsFME_TILE_TYPE_FIXED
, the band tile size (fromgetNumTileRows()
andgetNumTileCols()
) is a requirement. That is, only tiles of the specified size can be properly filled. WhengetTileType()
returnsFME_TILE_TYPE_FLEXIBLE
, the band tile size is only a suggestion, and it implies the most efficient tile size for data access.
Note that this value is only relevant for readers. That is, when creating a reader, this value should be specified depending on how
FMEBandTilePopulator
is implemented. On the other hand, a consumer of data (e.g. a writer) can always request data in whatever size is desired, regardless of this value. FME will reconcile the writer request size with the reader’s supported tile size.Return type: int Returns: Type of the tile.
-
hasBeenModified
()¶ Evaluates whether the band properties have been modified from their baseline state.
Return type: bool Returns: True
if the band properties have been modified
-
setInterpretation
(interpretation)¶ Sets the interpretation of the band.
-
setModified
(modified)¶ Sets whether band properties have been modified from baseline state.
Note that
hasBeenModified
is initially set to False.Parameters: modified (bool) – True
when properties is altered.Return type: None
-
setName
(name)¶ Sets name of the band.
Parameters: name (str) – The name of the band. Return type: None
-
setNumTileCols
(numCols)¶ Sets the number of columns per tile in the raster
Parameters: numCols (int) – Number of columns per tile in the raster. Number must be positive number, not exceeding the total number of columns. Return type: None Raises: FMEException – An exception is raised if an error occurred.
-
setNumTileRows
(numRows)¶ Sets the number of rows per tile in the raster.
Parameters: numRows (int) – Number of rows per tile in the raster. Number must be positive number, not exceeding the total number of rows. Return type: None Raises: FMEException – An exception is raised if an error occurred.
-
setTileType
(tileType)¶ Sets the tile type that can most efficiently support data access.
Parameters: tileType (int) – Possible values: FME_TILE_TYPE_FIXED
: Tile requests made to a band must be equal to the band’s tile size.FME_TILE_TYPE_FIXED_MULTIPLE
: Tile requests made to a band must be a multiple of the band’s tile size.FME_TILE_TYPE_FLEXIBLE
: The band tile size is a suggestion only, and the band can handle any arbitrary tile size.
Return type: None