GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Geo::GDAL::FFI::Dataset(3) User Contributed Perl Documentation Geo::GDAL::FFI::Dataset(3)

Geo::GDAL::FFI::Dataset - A GDAL dataset

A collection of raster bands or vector layers. Obtain a dataset object by opening it with the Open method of Geo::GDAL::FFI object or by creating it with the Create method of a Driver object.

 my $driver = $dataset->GetDriver;

 my $w = $dataset->GetWidth;

 my $h = $dataset->GetHeight;

 my @size = $dataset->GetSize;

Returns the size (width, height) of the bands of this raster dataset.

 my $band = $dataset->GetBand($i);

Get the ith (by default the first) band of a raster dataset.

 my @bands = $dataset->GetBands;

Returns a list of Band objects representing the bands of this raster dataset.

 my $layer = $dataset->CreateLayer({Name => 'layer', ...});

Create a new vector layer into this vector dataset.

Named arguments are the following.

"Name"
Optional, string, default is ''.
"GeometryType"
Optional, default is 'Unknown', the type of the first geometry field; note: if type is 'None', the layer schema does not initially contain any geometry fields.
"SpatialReference"
Optional, a SpatialReference object, the spatial reference for the first geometry field.
"Options"
Optional, driver specific options in an anonymous hash.
"Fields"
Optional, a reference to an array of Field objects or schemas, the fields to create into the layer.
"GeometryFields"
Optional, a reference to an array of GeometryField objects or schemas, the geometry fields to create into the layer; note that if this argument is defined then the arguments GeometryType and SpatialReference are ignored.

 my $layer = $dataset->GetLayer($name);

If $name is strictly an integer, then returns the (name-1)th layer in the dataset, otherwise returns the layer whose name is $name. Without arguments returns the first layer.

 my $copy = $dataset->CopyLayer($layer, $name, {DST_SRSWKT => 'WKT of a SRS', ...});

Copies the given layer into this dataset using the name $name and returns the new layer. The options hash is mostly driver specific.

 #  build a spatial index
 $dataset->ExecuteSQL (qq{CREATE SPATIAL INDEX ON "$some_layer_name"});
 
 #  filter a data set using the SQLite dialect and a second geometry
 my $filtered = $dataset->ExecuteSQL (
   qq{SELECT "$fld1", "$fld2" FROM "$some_layer_name"},
   $some_geometry,
   'SQLite',
 );

 my $info = $dataset->Info($options);
 my $info = $dataset->Info(['-json', '-stats']);

This is the same as gdalinfo utility. $options is a reference to an array. Valid options are as per the gdalinfo <https://www.gdal.org/gdalinfo.html> utility.

 my $target = $source->Translate($path, $options, $progress, $progress_data);

Convert a raster dataset into another raster dataset. This is the same as the gdal_translate <https://www.gdal.org/gdal_translate.html> utility. $name is the name of the target dataset. $options is a reference to an array of switches.

 my $result = $dataset->Warp($args);

$args is a hashref, keys may be Destination, Input, Options, Progress, ProgressData.

Valid options are as per the gdalwarp <https://www.gdal.org/gdalwarp.html> utility.

 my $result = $dataset->VectorTranslate($args);

$args is a hashref, keys may be Destination, Input, Options, Progress, ProgressData.

Valid options are as per the ogr2ogr <https://www.gdal.org/ogr2ogr.html> utility.

 my $result = $dataset->DEMProcessing($path, $args);

$args is a hashref, keys may be Processing, ColorFilename, Options, Progress, ProgressData.

See also gdaldem <https://www.gdal.org/gdaldem.html>.

 my $result = $dataset->NearBlack($args);

$args is a hashref, keys may be Destination, Options, Progress, ProgressData.

Valid options are as per the nearblack <https://www.gdal.org/nearblack.html> utility.

 my $result = $dataset->Grid($path, $options, $progress, $progress_data);

Valid options are as per the gdal_grid <https://www.gdal.org/gdal_grid.html> utility.

 my $result = $dataset->Rasterize($args);
 my $result = $dataset->Rasterize({Options => [-b => 1, -at]});

$args is a hashref, keys may be Destination, Options, Progress, ProgressData.

Valid options are as per the gdal_rasterize <https://www.gdal.org/gdal_rasterize.html> utility.

 my $result = $dataset->BuildVRT($path, $args);

$args is a hashref, keys may be Input, Options, Progress, ProgressData.

This software is released under the Artistic License. See perlartistic.

Ari Jolma - Ari.Jolma at gmail.com

Geo::GDAL::FFI

Alien::gdal, FFI::Platypus, <http://www.gdal.org>

2021-03-16 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.