Inheritance diagram for Geo::GDAL::Dataset:

Public Class Methods
Geo::GDAL::Dataset	Open (scalar name, scalar access='ReadOnly')
Geo::GDAL::Dataset	OpenShared (scalar name, scalar access='ReadOnly')
Public Object Methods
list	Size ()
Geo::GDAL::Driver	GetDriver ()
Geo::GDAL::Band	Band (scalar index)
list	Bands ()
scalar	Projection (scalar projection)
scalar	GetProjection ()
scalar	SetProjection (scalar proj)
list	GeoTransform (list geo_transform)
listref	GetGeoTransform ()
	SetGeoTransform (listref GeoTransform)
	BuildOverviews (scalar resampling, listref overviews, scalar callback, scalar callback_data)
list	GCPs (list GCPs, scalar GCPProjection)
scalar	GetGCPCount ()
scalar	GetGCPProjection ()
listref	GetGCPs ()
	SetGCPs (listref GCPs, scalar GCPProjection)
	FlushCache ()
	AddBand (scalar datatype= 'Byte', hashref options=0)
	WriteRaster (scalar xoff, scalar yoff, scalar xsize, scalar ysize, scalar buf, scalar buf_xsize=undef, scalar buf_ysize=undef, scalar buf_type=undef, listref band_list=undef)
scalar	ReadRaster (scalar xoff, scalar yoff, scalar xsize, scalar ysize, scalar buf_xsize=undef, scalar buf_ysize=undef, scalar buf_type=undef, listref band_list=undef)
	CreateMaskBand ()
Public Attributes
	RasterXSize
	RasterYSize
	RasterCount

Member Function Documentation

Geo::GDAL::Dataset::AddBand	(	scalar	datatype = `'Byte'`,
		hashref	options = `0`
	)

Add a new band to the dataset. The driver must support the action.

Parameters:

datatype	Data type string. The data type must be supported by the driver of this dataset. GDAL raster data types are Byte UInt16 Int16 UInt32 Int32 Float32 Float64 CInt16 CInt32 CFloat32 CFloat64.
options	A reference to a hash of format specific key=>value options.

Geo::GDAL::Band Geo::GDAL::Dataset::Band ( scalar index )

Create a band object for the band within the dataset.

Note:: aka GetRasterBand

Parameters:

index 1...RasterCount

Returns:: a new Geo::GDAL::Band object

list Geo::GDAL::Dataset::Bands ( )

Returns:: a list of new Geo::GDAL::Band objects

Geo::GDAL::Dataset::BuildOverviews	(	scalar	resampling,
		listref	overviews,
		scalar	callback,
		scalar	callback_data
	)

Parameters:

resampling	Either 'NEAREST', 'AVERAGE', or 'AVERAGE_MAGPHASE'.
overviews	The list of overview decimation factors to build. For example [2,4,8].
callback	[optional] a reference to a subroutine, which will be called with parameters (number progress, string msg, callback_data)
callback_data	[optional]

Geo::GDAL::Dataset::CreateMaskBand ( )

Geo::GDAL::Dataset::FlushCache ( )

Write cached data to disk. There is usually no need to call this method.

list Geo::GDAL::Dataset::GCPs	(	list	GCPs,
		scalar	GCPProjection
	)

Get or set the GCPs and their projection.

Parameters:

GCPs	[optional] a list of Geo::GDAL::GCP objects
GCPProjection	[optional] Projection string.

Returns:: a list of Geo::GDAL::GCP objects followed by a GCPProjection

list Geo::GDAL::Dataset::GeoTransform ( list geo_transform )

Transformation from pixel coordinates (x,y) to projection coordinates (Xp, Yp)

Xp = geo_transform[0] + x*geo_transform[1] + y*geo_transform[2]
Yp = geo_transform[3] + x*geo_transform[4] + y*geo_transform[5]

Parameters:

geo_transform [optional]

Returns:: the geo transform in a non-void context.

Geo::GDAL::Driver Geo::GDAL::Dataset::GetDriver ( )

Returns:: a new Geo::GDAL::Driver object

scalar Geo::GDAL::Dataset::GetGCPCount ( )

Returns:: the number of GCPs

scalar Geo::GDAL::Dataset::GetGCPProjection ( )

Returns:: projection string.

listref Geo::GDAL::Dataset::GetGCPs ( )

Returns:

listref Geo::GDAL::Dataset::GetGeoTransform ( )

Returns:: a reference to an array of six parameters.

scalar Geo::GDAL::Dataset::GetProjection ( )

Returns:: the projection as WKT

Geo::GDAL::Dataset Geo::GDAL::Dataset::Open	(	scalar	name,
		scalar	access = `'ReadOnly'`
	)

An example:

use Geo::GDAL;
$ds = Geo::GDAL::Dataset::Open('/data/dem.tiff', 'Update');

Parameters:

name
access	Either 'ReadOnly' or 'Update'.

Returns:: a new Geo::GDAL::Dataset object.

Reimplemented from Geo::GDAL.

Geo::GDAL::Dataset Geo::GDAL::Dataset::OpenShared	(	scalar	name,
		scalar	access = `'ReadOnly'`
	)

Parameters:

name
access	Either ReadOnly or Update.

Returns:: a new Geo::GDAL::Dataset object.

Reimplemented from Geo::GDAL.

scalar Geo::GDAL::Dataset::Projection ( scalar projection )

Get or set the projection.

Parameters:

projection [optional] as WKT

Returns:: the projection as WKT

scalar Geo::GDAL::Dataset::ReadRaster	(	scalar	xoff,
		scalar	yoff,
		scalar	xsize,
		scalar	ysize,
		scalar	buf_xsize = `undef`,
		scalar	buf_ysize = `undef`,
		scalar	buf_type = `undef`,
		listref	band_list = `undef`
	)

Read a buffer from the raster.

Parameters:

xoff
yoff
xsize
ysize
buf_xsize
buf_ysize
buf_type
band_list

Returns:: a buffer, open the buffer with unpack.

Geo::GDAL::Dataset::SetGCPs	(	listref	GCPs,
		scalar	GCPProjection
	)

Parameters:

GCPs
GCPProjection

Geo::GDAL::Dataset::SetGeoTransform ( listref GeoTransform )

Parameters:

GeoTransform

scalar Geo::GDAL::Dataset::SetProjection ( scalar proj )

Parameters:

proj	projection as WKT

list Geo::GDAL::Dataset::Size ( )

Returns:: (width, height)

Geo::GDAL::Dataset::WriteRaster	(	scalar	xoff,
		scalar	yoff,
		scalar	xsize,
		scalar	ysize,
		scalar	buf,
		scalar	buf_xsize = `undef`,
		scalar	buf_ysize = `undef`,
		scalar	buf_type = `undef`,
		listref	band_list = `undef`
	)

Write a buffer into the raster. Create the buffer with pack function of Perl. Entry in GDAL docs (method RasterIO)

Parameters:

xoff
yoff
xsize
ysize
buf
buf_xsize
buf_ysize
buf_type
band_list

Member Data Documentation

Geo::GDAL::Dataset::RasterCount

scalar (access as $dataset->{RasterCount})

Geo::GDAL::Dataset::RasterXSize

scalar (access as $dataset->{RasterXSize})

Geo::GDAL::Dataset::RasterYSize

scalar (access as $dataset->{RasterYSize})

The documentation for this class was generated from the following file:

lib/Geo/GDAL.pm

Geo::GDAL::Dataset Class Reference

Public Class Methods

Public Object Methods

Public Attributes

Member Function Documentation

Member Data Documentation