API GDALLink to this heading#

Data ContohLink to this heading#

The GDAL/OGR tools described here are designed to help you read in your geospatial data, in order for most of them to be useful you have to have some data to work with. If you're starting out and don't yet have any data of your own to use, GeoDjango tests contain a number of data sets that you can use for testing. You can download them here:

$ wget https://raw.githubusercontent.com/django/django/master/tests/gis_tests/data/cities/cities.{shp,prj,shx,dbf}
$ wget https://raw.githubusercontent.com/django/django/master/tests/gis_tests/data/rasters/raster.tif

DataSourceLink to this heading#

DataSource is a wrapper for the OGR data source object that supports reading data from a variety of OGR-supported geospatial file formats and data sources using a consistent interface. Each data source is represented by a DataSource object which contains one or more layers of data. Each layer, represented by a Layer object, contains some number of geographic features (Feature), information about the type of features contained in that layer (e.g. points, polygons, etc.), as well as the names and types of any additional fields (Field) of data that may be associated with each feature in that layer.

class DataSource(ds_input, encoding='utf-8')Link to this definition#

Pembangun untuk DataSource hanya membutuhkan satu parameter: jalur dari berkas anda ingin baca. Bagaimanapun, OGR juga mendukung beragam sumber data lebih rumit, termasuk basisdata, yang mungkin diakses dengan melewatkan string nama khusus daripada jalur. Untuk informasi lebih, lihat dokumentasi OGR Vector Formats. Sifat name dari sebuah instance DataSource memberikan nama OGR dari sumber data pokok yang itu sedang gunakan.

Pilihan parameter encoding mengizinkan anda menentukan penyandian bukan-standar dari string di sumber. Ini khususnya berguna ketika anda mendapatkan pengecualian DjangoUnicodeDecodeError selagi membaca nilai bidang.

Sekali anda telah membuat DataSource anda, anda dapat menemukan seberapa banyak lapisan data itu kandung dengan mengakses sifat layer_count, atau (setara) dengan menggunakan fungsi len(). Untuk informasi pada mengakses lapisan dari data mereka sendiri, lihat bagian lain:

Code

>>> from django.contrib.gis.gdal import DataSource
>>> ds = DataSource('/path/to/your/cities.shp')
>>> ds.name
'/path/to/your/cities.shp'
>>> ds.layer_count                  # This file only contains one layer
1

layer_countLink to this definition#

Mengembalikan sejumlah lapisan di sumber data.

nameLink to this definition#

Mengembalikan nama dari sumber data.

LapisanLink to this heading#

class LayerLink to this definition#

Layer adalah sebuah pembungkus untuk lapisan dari data di obyek DataSource. Anda tidak pernah membuat obyek Layer secara langsung. Sebagai gantinya, anda mengambil mereka dari obyek DataSource, yang pada dasarnya wadah standar Python dari obyek Layer. Sebagai contoh, anda dapat mengakses lapisan khusus dengan indeksnya (misalnya ds[0] untuk mengakses lapisan pertama), atau anda dapat mengulang terhadap semua lapisan di wadah dalam perulangan loop. Layer itu sendiri bertindak sebagai sebuah wadah untuk fitur-fitur geometris.

Khususnya, semua fitur di lapisan yang diberikan mempunyai jenis geometri sama. Sifat geom_type dari lapisan adalah sebuah OGRGeomType yang mencirikan jenis fitur. Kami dapat menggunakan itu untuk mencetak beberapa informasi dasar tentang setiap lapisan di DataSource:

Code

>>> for layer in ds:
...     print('Layer "%s": %i %ss' % (layer.name, len(layer), layer.geom_type.name))
...
Layer "cities": 3 Points

Keluaran contoh adalah dari sumber data kota, dimuat diatas, yang ternyata mengandung satu lapisan, dipanggil "cities", yang mengandung tida titik fitur. Untuk kemudahan, contoh-contoh diatas menganggap bahwa anda telah menyimpan lapisan itu di variabel layer:

Code

>>> layer = ds[0]

nameLink to this definition#

Mengembalikan nama lapisan ini di sumber data.

Code

>>> layer.name
'cities'

num_featLink to this definition#

Mengembalikan sejumlah fitur-fitur di lapisan. Sama seperti len(layer):

Code

>>> layer.num_feat
3

geom_typeLink to this definition#

Mengembalikan jenis geometri dari lapisan, sebagai sebuah obyek OGRGeomType:

Code

>>> layer.geom_type.name
'Point'

num_fieldsLink to this definition#

Mengembalikan sejumlah bidang di lapisan, yaitu sejumlah bidang dari data terhubung dengan setiap fitur di lapisan:

Code

>>> layer.num_fields
4

fieldsLink to this definition#

Mengembalikan daftar nama dari setiap bidang di lapisan ini:

Code

>>> layer.fields
['Name', 'Population', 'Density', 'Created']

Mengembalikan daftar dari jenis-jenis data dari setiap bidang di lapisan ini. Ini adalah subkelas dari Field, diobrolkan dibawah:

Code

>>> [ft.__name__ for ft in layer.field_types]
['OFTString', 'OFTReal', 'OFTReal', 'OFTDate']

field_widthsLink to this definition#

Mengembalikan daftar dari bidang maksimal untuk setiap bidang dalam lapisan ini:

Code

>>> layer.field_widths
[80, 11, 24, 10]

field_precisionsLink to this definition#

Mengembalikan daftar dari angka ketelitian untuk setiap dari bidang-bidang dalam lapisan ini. Ini tidak berarti (dan disetel ke nol) untuk bidang bukan-numerik:

Code

>>> layer.field_precisions
[0, 0, 15, 0]

extentLink to this definition#

Mengembalikan tingkatan spasial dari lapisan ini, sebagai sebuah obyek Envelope:

Code

>>> layer.extent.tuple
(-104.609252, 29.763374, -95.23506, 38.971823)

srsLink to this definition#

Sifat yang mengembalikan SpatialReference terkait dengan lapisan ini:

Code

>>> print(layer.srs)
GEOGCS["GCS_WGS_1984",
    DATUM["WGS_1984",
        SPHEROID["WGS_1984",6378137,298.257223563]],
    PRIMEM["Greenwich",0],
    UNIT["Degree",0.017453292519943295]]

Jika Layer tidak mempunyai informasi acuan spasial terkait dengan itu, `` None`` dikembalikan.

spatial_filterLink to this definition#

Sifat mungkin digunakan untuk mengambil atau menyetel penyaring spasial untuk lapisan ini. Sebuah penyaring spasial hanya dapat disetel dengan sebuah instance OGRGeometry, sebuah perpanjangan 4-tuple, atau None. Ketika menyetel dengan sesuatu selain dari None, hanya fitur-fitur yang saling menyilang penyaring akan dikembalikan ketika memutar terhadap lapisan:

Code

>>> print(layer.spatial_filter)
None
>>> print(len(layer))
3
>>> [feat.get('Name') for feat in layer]
['Pueblo', 'Lawrence', 'Houston']
>>> ks_extent = (-102.051, 36.99, -94.59, 40.00) # Extent for state of Kansas
>>> layer.spatial_filter = ks_extent
>>> len(layer)
1
>>> [feat.get('Name') for feat in layer]
['Lawrence']
>>> layer.spatial_filter = None
>>> len(layer)
3

get_fields()Link to this definition#

Sebuah metode yang mengembalikan sebuah daftar dari nilai-nilai dari bidang yang diberikan untuk setiap fitur dalam lapisan:

Code

>>> layer.get_fields('Name')
['Pueblo', 'Lawrence', 'Houston']

get_geoms(geos=False)Link to this definition#

Sebuah metode yang mengembalikan sebuah list mengandung geometri dari setiap fitur dalam lapisan. Jika argumen pilihan geos disetel menjadi True kemudian geometri dirubah ke obyek GEOSGeometry. Sebaliknya, mereka dikembalikan sebagai obyek OGRGeometry:

Code

>>> [pt.tuple for pt in layer.get_geoms()]
[(-104.609252, 38.255001), (-95.23506, 38.971823), (-95.363151, 29.763374)]

test_capability(capability)Link to this definition#

Mengembalikan boolean menunjukkan apakah lapisan ini mendukung kemampuan yang diberikan (sebuah string). Contoh dari kemampuan sah termasuk: 'RandomRead', 'SequentialWrite', 'RandomWrite', 'FastSpatialFilter', 'FastFeatureCount', 'FastGetExtent', 'CreateField', 'Transactions', 'DeleteFeature', dan 'FastSetNextByIndex'.

FeatureLink to this heading#

class FeatureLink to this definition#

Feature membungkus fitur OGR. Anda tidak pernah membuat obyek Feature secara langsung. Sebagai gantinya, anda mengambil mereka dari obyek Layer. Setiap fitur terdiri dari sebuah geometri dan sekumpulan bidang mengandung sifat-sifat tambahan. Geometri dari sebuah bidang adalah dapat diakses melalui sifat geom nya, yang mengembalikan sebuah obyek OGRGeometry. Sebuah Feature berperilaku seperti wadah Python standar untuk bidangnya, yang itu dikembalikan sebagai obyek Field: anda dapat mengakses sebuah bidang secara langsung berdasarkan indeks atau namanya, atau dapat berulang terhadap bidang-bidang fitur, misalnya di sebuah perulangan for.

geomLink to this definition#

Mengembalikan geometri untuk fotur ini, sebagai sebuah obyek OGRGeometry:

Code

>>> city.geom.tuple
(-104.609252, 38.255001)

getLink to this definition#

Sebuah metode yang mengembalikan nilai dari bidang yang diberikan (ditentukan oleh nama) untuk fitur ini, bukan sebuah obyek pembungkus Field:

Code

>>> city.get('Population')
102121

geom_typeLink to this definition#

Mengembalikan jenis geometri untuk fitur ini, sebagai sebuah obyek OGRGeomType. Ini akan sama untuk semua fitur dalam lapisan yang diberikan dan setara pada sifat Layer.geom_type dari obyek Layer fitur berasal.

num_fieldsLink to this definition#

Mengembalikan sejumlah bidang-bidang dari data terkait dengan fitur. Ini akan sama untuk semua fitur dalam lapisan yang diberikan dan setara pada sifat Layer.num_fields dari obyek Layer fitur berasal.

fieldsLink to this definition#

Mengembalikan daftar dari nama-nama dari bidang data terkait dengan fitur. Ini akan sama untuk semua fitur dalam lapisan yang diberikan dan setara pada sifat Layer.fields dari fitur obyek Layer yang datang.

fidLink to this definition#

Mengembalikan penciri fitur dalam lapisan:

Code

>>> city.fid
0

layer_nameLink to this definition#

Mengembalikan nama dari Layer yang berasal fitur. Ini akan menjadi sama untuk semua fitur dalam lapisan yang diberikan:

Code

>>> city.layer_name
'cities'

indexLink to this definition#

Sebuah metode yang mengembalikan indeks dari nama bidang yang diberikan. Ini akan sama untuk semua fitur-fitur dalam lapisan yang diberikan:

Code

>>> city.index('Population')
1

FieldLink to this heading#

class FieldLink to this definition#

nameLink to this definition#

Mengembalikan nama dari bidang ini:

Code

>>> city['Name'].name
'Name'

typeLink to this definition#

Mengembalikan jenis OGR dari bidang ini, sebagai sebuah integer. Dictionary FIELD_CLASSES memetakan nilai-nilai ini kedalam subkelas dari Field:

Code

>>> city['Density'].type
2

type_nameLink to this definition#

Mengembalikan string dengan nama dari jenis data dari bidang ini:

Code

>>> city['Name'].type_name
'String'

valueLink to this definition#

Mengembalikan nilai dari bidang ini. Kelas Field itu sendiri mengembalikan nilai sebagai sebuah string, tetapi setiap subkelas mengembalikan nilai dalam bentuk paling sesuai:

Code

>>> city['Population'].value
102121

widthLink to this definition#

Mengembalikan lebar bidang ini:

Code

>>> city['Name'].width
80

precisionLink to this definition#

Mengembalikan ketelitian numerik dari bidang ini. Ini tidak berarti (dan disetel ke nol) untuk bidang-bidang bukan-numerik:

Code

>>> city['Density'].precision
15

as_double()Link to this definition#

Mengembalikan nilai dari bidang sebagai double (float):

Code

>>> city['Density'].as_double()
874.7

as_int()Link to this definition#

Mengembalikan nilai dari bidang sebagai integer:

Code

>>> city['Population'].as_int()
102121

as_string()Link to this definition#

Mengembalikan nilai dari bidang sebagai deretan kalimat:

Code

>>> city['Name'].as_string()
'Pueblo'

as_datetime()Link to this definition#

Mengembalikan nilai dari bidang sebagai tuple dari komponen tanggal dan waktu:

Code

>>> city['Created'].as_datetime()
(c_long(1999), c_long(5), c_long(23), c_long(0), c_long(0), c_long(0), c_long(0))

DriverLink to this heading#

class Driver(dr_input)Link to this definition#

Kelas Driver digunakan secara mendalam untuk membungkus sebuah driver DataSource OGR.

driver_countLink to this definition#

Mengembalikan sejumlah driver vektor OGR saat ini terdaftar.

OGRGeometryLink to this heading#

Obyek-obyek OGRGeometry berbagi fungsi mirip dengan obyek GEOSGeometry dan pembungkus tipis disekitar perwakilan geometri internal OGR. Dengan demikian, mereka mengizinkan untuk lebih efektid mengakses ke data ketika menggunakan DataSource. Tidak seprti pasangan GEOS nya, OGRGeometry mendukung sistem acuan spasial dan perubahan kordinat:

>>> from django.contrib.gis.gdal import OGRGeometry
>>> polygon = OGRGeometry('POLYGON((0 0, 5 0, 5 5, 0 5))')

class OGRGeometry(geom_input, srs=None)Link to this definition#

Obyek ini adalah sebuah pembungkus untuk kelas OGR Geometry. Obyek-obyek ini diinstasiasikan secara langsung dari parameter geom_input yang diberikan, yang mungkin berupa string mengandung WKT, HEX, GeoJSON, sebuah buffer mengandung data WKB, atau sebuah obyek OGRGeomType. Obyek-obyek ini juga dikembalikan dari atribut Feature.geom, ketika membaca data vektor dari Layer (yaitu pada giliran bagian dari sebuah DataSource).

classmethod from_gml(gml_string)Link to this definition#

Membangun sebuah OGRGeometry dari string GML yang diberikan.

classmethod from_bbox(bbox)Link to this definition#

Membangun sebuah Polygon dari kotak-terikat diberikan (4-tuple).

__len__()Link to this definition#

Mengembalikan sejumlah titik dalam sebuah LineString, sejumlah geometri dalam sebuah GeometryCollection. Tidak diberlakukan ke jenis geometri lain.

__iter__()Link to this definition#

Perulangan terhadap titik-titik dalam sebuah LineString, lingkaran dalam Polygon, atau geometri dalam sebuah GeometryCollection. Tidak dapat diterapkan pada jenis-jenis geometri lain.

__getitem__()Link to this definition#

Mengembalikan titik pada indeks yang ditentukan untuk LineString, lingkaran dalam pada indeks ditentukan untuk Polygon, atau geometri pada indeks ditentukan dalam sebuah GeometryCollection. Tidak dapat diberlakukan pada jenis-jenis geometri lain.

dimensionLink to this definition#

Mengembalikan sejumlah dimensi kordinat dari geometri, yaitu 0 untuk titik, 1 untuk baris, dan sebagainya:

Code

>> polygon.dimension
2

coord_dimLink to this definition#

mengembalikan atau menyetel dimensi kordinat dari geometri ini. Sebagai contoh, nilai akan berupa 2 untuk geometri dua-dimensi.

geom_countLink to this definition#

Mengembalikan sejumlah unsur dalam geometri ini:

Code

>>> polygon.geom_count
1

point_countLink to this definition#

Mengembalikan sejumlah titik digunakan untuk menggambarkan geometri ini:

Code

>>> polygon.point_count
4

num_pointsLink to this definition#

Nama lain untuk point_count.

num_coordsLink to this definition#

Nama lain untuk point_count.

geom_typeLink to this definition#

Mengembalikan jenis dari geometri ini, sebagai sebuah obyek OGRGeomType.

geom_nameLink to this definition#

Mengembalikan nama dari jenis dari geometri ini:

Code

>>> polygon.geom_name
'POLYGON'

areaLink to this definition#

Mengembalikan kawasan dari geometri ini, atau 0 untuk geometri yang tidak mengandung sebuah kawasan:

Code

>>> polygon.area
25.0

envelopeLink to this definition#

Mengembalikan sampul dari geometri ini, sebagai sebuah obyek Envelope.

extentLink to this definition#

Mengembalikan amplop dari geometri ini sebagai 4-tuple, sebagai ganti dari Envelope object:

Code

>>> point.extent
(0.0, 0.0, 5.0, 5.0)

srsLink to this definition#

Sifat ini mengendalikan acuan spasial untuk geometri ini, atau None jika tidak ada sisterm acuan spasia telah diberikan ke itu. Jika diberikan, mengakses sifat ini mengembalikan sebuah obyek SpatialReference. Itu mungkin disetel dengan obyek SpatialReference lain, atau masukan apapun yang SpatialReference terima. Contoh:

Code

>>> city.geom.srs.name
'GCS_WGS_1984'

sridLink to this definition#

Mengembalikan atau menyetel penciri acuan berhubungan pada SpatialReference dari geometri ini. Mengembalikan None jika tidak ada informasi acuan spasial terkait dengan geometri ini, atau jika sebuah SRID tidak dapat ditentukan.

geosLink to this definition#

Mengebalikan obyek GEOSGeometry sesuai pada geometri ini.

gmlLink to this definition#

Mengembalikan sebuah string perwakilan dari geometri ini dalam bentuk GML:

Code

>>> OGRGeometry('POINT(1 2)').gml
'<gml:Point><gml:coordinates>1,2</gml:coordinates></gml:Point>'

hexLink to this definition#

Mengembalikan perwakilan string dari geometri ini dalam bentuk HEX WKB:

Code

>>> OGRGeometry('POINT(1 2)').hex
'0101000000000000000000F03F0000000000000040'

jsonLink to this definition#

Mengembalikan string perwakilan dari geometri ini dalam bentuk JSON:

Code

>>> OGRGeometry('POINT(1 2)').json
'{ "type": "Point", "coordinates": [ 1.000000, 2.000000 ] }'

kmlLink to this definition#

Mengembalikan perwakilan string dari geometri ini dalam bentuk KML.

wkb_sizeLink to this definition#

Mengembalikan ukuran dari penyangga WKB untuk menahan perwakilan WKB dari geometri ini:

Code

>>> OGRGeometry('POINT(1 2)').wkb_size
21

wkbLink to this definition#

Mengembalikan sebuah buffer mengandung perwakilan WKB dari geometri ini.

wktLink to this definition#

Mengembalikan perwakilan string dari geometri ini dalam bentuk WKT.

ewktLink to this definition#

Mengembalikan perwakilan EWKT dari geometri ini.

clone()Link to this definition#

Mengembalikan klon baru OGRGeometry dari obyek geometri ini.

close_rings()Link to this definition#

Jika ada lingkaran apapun dalam geometri ini yang belum ditutup, rutin ini akan melakukannya dengan menambahkan titik awalan ke akhiran:

Code

>>> triangle = OGRGeometry('LINEARRING (0 0,0 1,1 0)')
>>> triangle.close_rings()
>>> triangle.wkt
'LINEARRING (0 0,0 1,1 0,0 0)'

transform(coord_trans, clone=False)Link to this definition#

Merubah geometri ini menjadi sistem acuan spasial berbeda. Mungkin ambil obyek CoordTransform, sebuah obyek SpatialReference, atau masukan apapun yang diterima oleh SpatialReference (termasuk WKT acuan spasial dan string PROJ.4, atau integer SRID).

Secara awalan dikembalikan dan geometri dirubah di-tempat. Bagaimanapun, jika kata kunci clone disetel menjadi True kemudian kloningan dirubah dari geometri dikembalikan sebagai gantinya

intersects(other)Link to this definition#

Mengembalikan True jika geometri ini memotong ke lain, sebaliknya mengembalikan False.

equals(other)Link to this definition#

Mengembalikan True jika geometri ini setara dengan lain, sebaliknya mengembalikan True.

disjoint(other)Link to this definition#

Mengembalikan True jka geometri ini secara spasial menguraikan ke (yaitu tidak bersimpangan) lain, sebaliknya mengembalikan False.

touches(other)Link to this definition#

Mengembalikan True jika geometri ini menyentuh lainnya, sebaliknya mengembalikan False.

crosses(other)Link to this definition#

Mengembalikan True jika geometri ini bersilangan ke lainnya, sebaliknya mengembalikan False.

within(other)Link to this definition#

Mengembalikan True jika geometri ini mengandung dalam yang lain, sebaliknya mengembalikan False.

contains(other)Link to this definition#

Mengembalikan True jika geometri ini mengandung yang lainnya, sebaliknya mengembalikan False.

overlaps(other)Link to this definition#

Mengembalikan True jika geometri ini tumpang tindih yang lain, sebaliknya mengembalikan False.

boundary()Link to this definition#

Batasan geometri ini , sebagai sebuah obyek OGRGeometry baru.

convex_hullLink to this definition#

Poligon cembung terkecil yang megnandung geometri ini, sebagai sebuah obyek OGRGeometry baru.

difference()Link to this definition#

Mengembalikan kawasan terdiri dari perbedaan dari geometri dan lainnya, seperti obyek OGRGeometry baru.

intersection()Link to this definition#

Mengembalikan kawasan terdiri dari persimpangan dari geometri dan lainnya, seperti obyek OGRGeometry baru.

sym_difference()Link to this definition#

Mengembalikan kawasan terdiri dari perbedaan simetris dari geometri dan lainnya, seperti obyek OGRGeometry baru.

union()Link to this definition#

Mengembalikan kawasan terdiri dari penggabungan dari geometri dan lainnya, seperti obyek OGRGeometry baru.

tupleLink to this definition#

Mengembalikan kordinat-kordinat dari titik geometri sebagai sebuah tuple, kordinat-kordinat dari baris geometri sebagai sebuah tuple dari tuple, dan sebagainya:

Code

>>> OGRGeometry('POINT (1 2)').tuple
(1.0, 2.0)
>>> OGRGeometry('LINESTRING (1 2,3 4)').tuple
((1.0, 2.0), (3.0, 4.0))

coordsLink to this definition#

Sebuah nama lain untuk tuple.

class PointLink to this definition#

xLink to this definition#

Mengembalikan kordinat X dari titik ini:

Code

>>> OGRGeometry('POINT (1 2)').x
1.0

yLink to this definition#

Mengembalikan kordinat Y dari titik ini:

Code

>>> OGRGeometry('POINT (1 2)').y
2.0

zLink to this definition#

Mengembalikan kordinat Z pada titik ini, atau None jika titik tidak memiliki kordinat Z:

Code

>>> OGRGeometry('POINT (1 2 3)').z
3.0

class LineStringLink to this definition#

xLink to this definition#

Mengembalikan sebuah daftar dari kordinat X dalam baris ini:

Code

>>> OGRGeometry('LINESTRING (1 2,3 4)').x
[1.0, 3.0]

yLink to this definition#

Mengembalikan sebuah daftar dari kordinat Y dalam baris ini:

Code

>>> OGRGeometry('LINESTRING (1 2,3 4)').y
[2.0, 4.0]

zLink to this definition#

Mengembalikan list dari kordinat Z pada baris ini, atau None jika baris tidak memiliki kordinat Z:

Code

>>> OGRGeometry('LINESTRING (1 2 3,4 5 6)').z
[3.0, 6.0]

class PolygonLink to this definition#

shellLink to this definition#

Mengembalikan cangkang atau eksterior lingkaran dari poligon ini, sebagai geometri LinearRing.

exterior_ringLink to this definition#

Sebuah nama lain untuk shell.

centroidLink to this definition#

Mengembalikan Point mewakili pust dari poligon ini.

class GeometryCollectionLink to this definition#

add(geom)Link to this definition#

Menambah geometri ke kumpulan geometri. Tidak dapat diterapkan pada jenis geometri lain.

OGRGeomTypeLink to this heading#

class OGRGeomType(type_input)Link to this definition#

Kelas ini mengizinkan untuk gambaran dari jenis geometri OGR dalam beberapa cara:

Code

>>> from django.contrib.gis.gdal import OGRGeomType
>>> gt1 = OGRGeomType(3)             # Using an integer for the type
>>> gt2 = OGRGeomType('Polygon')     # Using a string
>>> gt3 = OGRGeomType('POLYGON')     # It's case-insensitive
>>> print(gt1 == 3, gt1 == 'Polygon') # Equivalence works w/non-OGRGeomType objects
True True

nameLink to this definition#

Mengembalikan formulir string tangan-pendek dari jenis geometri OGR:

Code

>>> gt1.name
'Polygon'

numLink to this definition#

Mengembalikan sejumlah kaitan pada jenis geometri OGR:

Code

>>> gt1.num
3

djangoLink to this definition#

Mengembalikan jenis bidang Django (sebuah subkelas dari GeometryField) untuk digunakan menyimpan jenis OGR ini, atau None jika tidak ada jenis Django yang sesuai:

Code

>>> gt1.django
'PolygonField'

EnvelopeLink to this heading#

class Envelope(*args)Link to this definition#

mewakili sebuah struktur Sampul OGR yang mengandung kordinat minimual dan maksimal X, Y untuk kotak pembatas empat persegi panjang. Penamaan dari variabel adalah cocok dengan struktur Sampul OGR C.

min_xLink to this definition#

Nilai minimal kordinat X

min_yLink to this definition#

Nilai maksimal kordinat X.

max_xLink to this definition#

Nilai minimal kordinat Y.

max_yLink to this definition#

Nilai maksimal kordinat Y.

urLink to this definition#

Kordinat atas-kanan, sebagai sebuah tuple.

llLink to this definition#

Kordinat kiri-bawah, sebagai sebuah tuple.

tupleLink to this definition#

Sebuah tuple mewakili bungkus.

wktLink to this definition#

Sebuah string mewakili amplop ini sebagai poligon dalam bentuk WKT.

expand_to_include(*args)Link to this definition#

SpatialReferenceLink to this heading#

class SpatialReference(srs_input)Link to this definition#

Obyek acuan spasial diinisialisasikan pada srs_input diberikan, yang mungkin satu dari berikut:

• OGC Well Known Text (WKT) (sebuah string)

• Kode EPSG(integer atau string)

• String PROJ.4

• Sebuah string tulisan cepat untuk standar dikenal-baik ('WGS84', 'WGS72', 'NAD27', 'NAD83')

Contoh:

Code

>>> wgs84 = SpatialReference('WGS84') # shorthand string
>>> wgs84 = SpatialReference(4326) # EPSG code
>>> wgs84 = SpatialReference('EPSG:4326') # EPSG string
>>> proj4 = '+proj=longlat +ellps=WGS84 +datum=WGS84 +no_defs '
>>> wgs84 = SpatialReference(proj4) # PROJ.4 string
>>> wgs84 = SpatialReference("""GEOGCS["WGS 84",
DATUM["WGS_1984",
     SPHEROID["WGS 84",6378137,298.257223563,
         AUTHORITY["EPSG","7030"]],
     AUTHORITY["EPSG","6326"]],
 PRIMEM["Greenwich",0,
     AUTHORITY["EPSG","8901"]],
 UNIT["degree",0.01745329251994328,
     AUTHORITY["EPSG","9122"]],
 AUTHORITY["EPSG","4326"]]""") # OGC WKT

__getitem__(target)Link to this definition#

Mengembalikan nilai dari node atribut string diberikan, None jika node tidak ada. Dapat juga mengambil sebuah tuple sebagai sebuah parameter, (sasaran anak), dimana anak adalah indeks dari atriut dalam WKT. Sebagai contoh:

Code

>>> wkt = 'GEOGCS["WGS 84", DATUM["WGS_1984, ... AUTHORITY["EPSG","4326"]]')
>>> srs = SpatialReference(wkt) # could also use 'WGS84', or 4326
>>> print(srs['GEOGCS'])
WGS 84
>>> print(srs['DATUM'])
WGS_1984
>>> print(srs['AUTHORITY'])
EPSG
>>> print(srs['AUTHORITY', 1]) # The authority value
4326
>>> print(srs['TOWGS84', 4]) # the fourth value in this wkt
0
>>> print(srs['UNIT|AUTHORITY']) # For the units authority, have to use the pipe symbol.
EPSG
>>> print(srs['UNIT|AUTHORITY', 1]) # The authority value for the units
9122

attr_value(target, index=0)Link to this definition#

Nilai atribut untuk node sasaran diberikan (misalnya 'PROJCS'). Kata kunci indeks menentukan sebuah indeks dari node anak untuk kembali.

auth_name(target)Link to this definition#

Mengembalikan nama wewenang untuk node sasaran string yang diberikan.

auth_code(target)Link to this definition#

Mengembalikan kode wewenang untuk node sasaran string yang diberikan.

clone()Link to this definition#

Mengembalikan kloning dari obyek acuan spasial ini.

identify_epsg()Link to this definition#

Metode ini memeriksa WKT dari SpatialReference ini dan akan menambahkan node-node wewenang EPSG dimana sebuah penciri EPSG dapat diterapkan.

from_esri()Link to this definition#

Morphs this SpatialReference from ESRI's format to EPSG

to_esri()Link to this definition#

Morphs this SpatialReference to ESRI's format.

validate()Link to this definition#

Memeriksa untuk melihat jika acuan spasial diberikan adalah sah, jika tidak sebuah pengecualian akan dimunculkan.

import_epsg(epsg)Link to this definition#

Impor acuan spasial dari kode EPSG.

import_proj(proj)Link to this definition#

Impor acuan spasial dari string PROJ.4.

import_user_input(user_input)Link to this definition#

import_wkt(wkt)Link to this definition#

Impor acuan spasial dari WKT.

import_xml(xml)Link to this definition#

Mengimpor acuan spasial dari XML.

nameLink to this definition#

Mengembalikan nama dari Spatial Reference ini.

sridLink to this definition#

Mengembalikan SRID dari otoritas tingkat-tinggi, atau None jika tidak ditentukan.

linear_nameLink to this definition#

Mengambalikan nama dari satuan linear.

linear_unitsLink to this definition#

Mengembalikan nilai dari satuan linear.

angular_nameLink to this definition#

Mengembalikan nama dari satuan sudut."

angular_unitsLink to this definition#

Mengembalikan nilai dari satuan sudut.

unitsLink to this definition#

Mengembalikan 2-tuple dari nilai satuan dan nama satuan dan akan otomatis menentukan apakah mengembalikan satuan segaris atau bersinggungan.

ellipsoidLink to this definition#

Mengembalikan sebuah tuple dari parameter ellipsoid untuk acuan spasial ini: (sumbu semimajor, sumbu semiminor, dan kebalikan terbalik).

semi_majorLink to this definition#

Mengembalikan sumbu semi major dari ellipsoid untuk acuan spasial ini.

semi_minorLink to this definition#

Mengembalikan sumbu semi minor dari ellipsoid untuk acuan spasial ini.

inverse_flatteningLink to this definition#

Mengembalikan kebalikan terbalik dari ellipsoid untuk acuan spasial ini.

geographicLink to this definition#

Mengembalikan True jika acuan spasial ini adalah geografis (node akar adalah GEOGCS).

localLink to this definition#

Mengembalikan True jika acuan spasial ini adalah lokal (node akar adalah LOCAL_CS).

projectedLink to this definition#

Mengembalikan True jika acuan spasial ini adalah sistem kordinat terproyeksi (node akar adalah PROJCS).

wktLink to this definition#

Mengembalikan perwakilan WKT dari acuan spasial ini.

pretty_wktLink to this definition#

Mengembalikan perwakilan 'pretty' dari WKT.

projLink to this definition#

Mengembalikan perwakilan PROJ.4 dari acuan spasial ini.

proj4Link to this definition#

Nama lain untuk SpatialReference.proj.

xmlLink to this definition#

Mengembalikan perwakilan XML dari acuan spasial ini.

CoordTransformLink to this heading#

class CoordTransform(source, target)Link to this definition#

Mewakili sebuah perubahan bentuk sistem kordinat. Itu diinisialisasikan dengan dua SpatialReference, mewakili sumber dan sasaran sistem kordinat, masing-masing. Obyek-obyek ini harus digunakan ketika melakukan perubahan bentuk kordinat yang sama secara berulang pada geometri berbeda:

>>> ct = CoordTransform(SpatialReference('WGS84'), SpatialReference('NAD83'))
>>> for feat in layer:
...     geom = feat.geom # getting clone of feature geometry
...     geom.transform(ct) # transforming

GDALRasterLink to this heading#

GDALRaster is a wrapper for the GDAL raster source object that supports reading data from a variety of GDAL-supported geospatial file formats and data sources using a consistent interface. Each data source is represented by a GDALRaster object which contains one or more layers of data named bands. Each band, represented by a GDALBand object, contains georeferenced image data. For example, an RGB image is represented as three bands: one for red, one for green, and one for blue.

class GDALRaster(ds_input, write=False)Link to this definition#

aPembangunan untuk GDALRaster menerima dua parameter. Parameter pertama menentukan sumber raster, dan parameter kedua ditentukan jika raster harus dibuka dalam suasana tulis. Untuk raster baru-dibuat, parameter kedua diabaikan dan raster baru selalu dibuat dalam suasana tulis.

Parameter pertama dapat mengambil tiga bentuk: string mewakili jalur berkas, dictionary dengan nilai-nilai menentukan raster baru, atau obyek byte mewakili berkas raster.

Jika masukan adalah jalur berkas, raster dibuka dari sana. Jika masukan adalah mentah dalam dictionary, parameter width, height, dan srid diwajibkan. Jika masukan adalah obyek byte, itu akan dibuka menggunakan sistem berkas maya GDAL.

Untuk gambaran rinci pada bagaimana membuat raster menggunakan masukan dictionary, lihat Membuat raster dari data. Untuk gambaran rinci pada bagaimana membuat raster-raster dalam sistem berkas maya, lihat Menggunakan Virtual Filesystem GDAL.

Contoh berikut menunjukkan bagaimana raster-raster dapat dibuat dari sumber masukan berbeda (menggunakan data contoh dari percobaan GeoDjango; lihat juga bagian Data Contoh).

Code

>>> from django.contrib.gis.gdal import GDALRaster
>>> rst = GDALRaster('/path/to/your/raster.tif', write=False)
>>> rst.name
'/path/to/your/raster.tif'
>>> rst.width, rst.height  # This file has 163 x 174 pixels
(163, 174)
>>> rst = GDALRaster({  # Creates an in-memory raster
...     'srid': 4326,
...     'width': 4,
...     'height': 4,
...     'datatype': 1,
...     'bands': [{
...         'data': (2, 3),
...         'offset': (1, 1),
...         'size': (2, 2),
...         'shape': (2, 1),
...         'nodata_value': 5,
...     }]
... })
>>> rst.srs.srid
4326
>>> rst.width, rst.height
(4, 4)
>>> rst.bands[0].data()
array([[5, 5, 5, 5],
       [5, 2, 3, 5],
       [5, 2, 3, 5],
       [5, 5, 5, 5]], dtype=uint8)
>>> rst_file = open('/path/to/your/raster.tif', 'rb')
>>> rst_bytes = rst_file.read()
>>> rst = GDALRaster(rst_bytes)
>>> rst.is_vsi_based
True
>>> rst.name  # Stored in a random path in the vsimem filesystem.
'/vsimem/da300bdb-129d-49a8-b336-e410a9428dad'

nameLink to this definition#

Nama dari sumber yang setara pada jalur berkas masukan atau nama disediakan ketika instansiasi.

Code

>>> GDALRaster({'width': 10, 'height': 10, 'name': 'myraster', 'srid': 4326}).name
'myraster'

driverLink to this definition#

The name of the GDAL driver used to handle the input file. For GDALRasters created from a file, the driver type is detected automatically. The creation of rasters from scratch is an in-memory raster by default ('MEM'), but can be altered as needed. For instance, use GTiff for a GeoTiff file. For a list of file types, see also the GDAL Raster Formats list.

Raster dalam-memori dibuat melalui contoh berikut:

Code

>>> GDALRaster({'width': 10, 'height': 10, 'srid': 4326}).driver.name
'MEM'

Sebuah berkas berdasarkan raster GeoTiff dibuat melalui contoh berikut:

Code

>>> import tempfile
>>> rstfile = tempfile.NamedTemporaryFile(suffix='.tif')
>>> rst = GDALRaster({'driver': 'GTiff', 'name': rstfile.name, 'srid': 4326,
...                   'width': 255, 'height': 255, 'nr_of_bands': 1})
>>> rst.name
'/tmp/tmp7x9H4J.tif'           # The exact filename will be different on your computer
>>> rst.driver.name
'GTiff'

widthLink to this definition#

Lebar dari sumber dalam pixel (sumbu-X).

Code

>>> GDALRaster({'width': 10, 'height': 20, 'srid': 4326}).width
10

heightLink to this definition#

Lebar dari sumber dalam pixel (sumbu-Y).

Code

>>> GDALRaster({'width': 10, 'height': 20, 'srid': 4326}).height
20

srsLink to this definition#

Sistem acuan spasial dari raster, seperti instance SpatialReference. SRS dapat dirubah dengan merubah itu ke SpatialReference lain atau menyediakan masukan apapun yang diterima oleh pembangun SpatialReference.

Code

>>> rst = GDALRaster({'width': 10, 'height': 20, 'srid': 4326})
>>> rst.srs.srid
4326
>>> rst.srs = 3086
>>> rst.srs.srid
3086

sridLink to this definition#

Spatial Reference System Identifier (SRID) dari raster. Sifat ini adalah jalan pintas untuk mendapatkan atau menyetel SRID melalui atribut srs.

Code

>>> rst = GDALRaster({'width': 10, 'height': 20, 'srid': 4326})
>>> rst.srid
4326
>>> rst.srid = 3086
>>> rst.srid
3086
>>> rst.srs.srid  # This is equivalent
3086

geotransformLink to this definition#

Matriks perubahan affine digunakan untuk pengacuan geo sumber, sebagai sebuah tuple dari enam koefisien yang memetakan kordinat pixel/baris menjadi ruang acuan geo menggunakan hubungan berikut:

Code

Xgeo = GT(0) + Xpixel*GT(1) + Yline*GT(2)
Ygeo = GT(3) + Xpixel*GT(4) + Yline*GT(5)

Nilai-nilai sama dapat diambil dengan mengakses sifat attr:origin (indeks 0 dan 3), scale (indeks 1 dan 5) dan skew (indeks 2 dan 4).

Awalnya adalah [0.0, 1.0, 0.0, 0.0, 0.0, -1.0].

Code

>>> rst = GDALRaster({'width': 10, 'height': 20, 'srid': 4326})
>>> rst.geotransform
[0.0, 1.0, 0.0, 0.0, 0.0, -1.0]

originLink to this definition#

Kordinat-kordinat dari kiri atas asli dari raster dalam sistem acuan spasial dari sumber, sebagai sebuah obyek titik dengan anggota x dn y.

Code

>>> rst = GDALRaster({'width': 10, 'height': 20, 'srid': 4326})
>>> rst.origin
[0.0, 0.0]
>>> rst.origin.x = 1
>>> rst.origin
[1.0, 0.0]

scaleLink to this definition#

Pixel width and height used for georeferencing the raster, as a point object with x and y members. See geotransform for more information.

Code

>>> rst = GDALRaster({'width': 10, 'height': 20, 'srid': 4326})
>>> rst.scale
[1.0, -1.0]
>>> rst.scale.x = 2
>>> rst.scale
[2.0, -1.0]

skewLink to this definition#

Koefisien tidak simetris digunakan untuk pengacuan geo raster, sebagai sebuah obyek titik dengan anggota x dan y. Dalam kasus gambar ke utara, koefisien ini keduanya 0.

Code

>>> rst = GDALRaster({'width': 10, 'height': 20, 'srid': 4326})
>>> rst.skew
[0.0, 0.0]
>>> rst.skew.x = 3
>>> rst.skew
[3.0, 0.0]

extentLink to this definition#

Perpanjang (nilai-nilai batasan) dari sumber raster, sebagai sebuah 4-tuple (xmin, ymin, xmax, ymax) dalam sistem acuan spasial dari sumber.

Code

>>> rst = GDALRaster({'width': 10, 'height': 20, 'srid': 4326})
>>> rst.extent
(0.0, -20.0, 10.0, 0.0)
>>> rst.origin.x = 100
>>> rst.extent
(100.0, -20.0, 110.0, 0.0)

bandsLink to this definition#

Daftar pita dari sumber, seperti contoh GDALBand.

Code

>>> rst = GDALRaster({"width": 1, "height": 2, 'srid': 4326,
...                   "bands": [{"data": [0, 1]}, {"data": [2, 3]}]})
>>> len(rst.bands)
2
>>> rst.bands[1].data()
array([[ 2.,  3.]], dtype=float32)

warp(ds_input, resampling='NearestNeighbour', max_error=0.0)Link to this definition#

Mengembalikan versi melengkung dari raster ini.

Parameter pelengkungan dapat ditentukan melalui argumen ds_input. Penggunaan ds_input sejalan pada argumen berhubungan dari pembangun kelas. Itu adalah sebuah dictionary dengan karakteristik dari sasaran raster. Nilai-nilai kunci dictionary yang diizinkan adalah lebar, tinggi, SRID, asli, skala, kemiringan, jenis data, driver, dan nama (nama berkas).

Secara awalan, fungsi melengkung menjaga kebanyakan parameter setara pada nilai-nilai dari raster sumber asli, jadi hanya parameter yang harus dirubah butuh ditentukan. Catat bahwa ini termasuk driver, jadi untuk raster berdasarkan berkas fungsi melengkung akan membuat raster baru pada cakram.

Parameter yang hanya disetel berbeda dari raster sumber adalah nama. Nilai awalan dari nama raster adalah nama dari sumber raster ditambahkan dengan '_copy' + source_driver_name. Untuk raster berdasarkan-berkas itu dianjurkan untuk menyediakan jalur berkas dari raster sasaran.

Algoritma contoh ulang digunakan untuk melengkungkan dapat ditentukan dengan argumen resampling. Awalan adalah NearestNeighbor, dan nilai lainnya diizinkan adalah Bilinear, Cubic, CubicSpline, Lanczos, Average, dan Mode.

Argumen max_error dapat digunakan untuk menentukan kesalahan maksimal diukur dalam masukan pixel yang diizinkan dalam mendekati perubahan. Awalan adalah 0.0 untuk perhitungan tepat.

Untuk pengguna akrab dengan GDAL, fungsi ini mempunyai fungsionalitas mirip pada kegunaan baris-perintah gdalwarp.

Sebagai contoh, fungsi pembungkus dapat digunakan untuk mengumpulkan raster untuk menggandakan dari skala pixel aslinya.

Code

>>> rst = GDALRaster({
...     "width": 6, "height": 6, "srid": 3086,
...     "origin": [500000, 400000],
...     "scale": [100, -100],
...     "bands": [{"data": range(36), "nodata_value": 99}]
... })
>>> target = rst.warp({"scale": [200, -200], "width": 3, "height": 3})
>>> target.bands[0].data()
array([[  7.,   9.,  11.],
       [ 19.,  21.,  23.],
       [ 31.,  33.,  35.]], dtype=float32)

transform(srid, driver=None, name=None, resampling='NearestNeighbour', max_error=0.0)Link to this definition#

Mengembalikan versi dirubah dari raster ini dengan SRID ditentukan.

Fungsi ini merubah raster saat ini mejadi sistem acuan spasial baru yang dapat ditentukan dengan sebah srid. Itu menghitung batasan dan skala dari raster saat ini dalam sistem acuan spasial baru dan memlengkungkan raster menggunakan fungsi warp.

Secara awalan, driver dari sumber raster digunakan dan nama dari raster adalah nama asli ditambahkan dengan '_copy' + source_driver_name. Sebuah driver berbeda dapat ditentukan dengan argumen driver dan name.

Algoritma contoh ulang adalah NearestNeighbour tetapi dapat dirubah menggunakan argumen resmpling. Maksimal kesalahan awalan diizinkan untuk contoh ulang adalah 0.0 dan dapat dirubah menggunakan argumen max_error. Obrolkan dokumen warp untuk rincian pada argumen-argumen tersebut.

Code

>>> rst = GDALRaster({
...     "width": 6, "height": 6, "srid": 3086,
...     "origin": [500000, 400000],
...     "scale": [100, -100],
...     "bands": [{"data": range(36), "nodata_value": 99}]
... })
>>> target = rst.transform(4326)
>>> target.origin
[-82.98492744885776, 27.601924753080144]

infoLink to this definition#

Mengembalikan string dengan ringkasan dari raster. Ini setara pada kegunaan baris perintah gdalinfo.

metadataLink to this definition#

Metadata dari raster ini, diwakili sebagai dictionary bersarang. Kunci tingkat-pertama adalah ranah metadata. Tingkat-kedua mengandung barang metadata dan nilai dari setiap ranah.

Untuk menyetel atau memperbaharui barang metadata, lewatkan barang metadata berhubungan ke metode menggunakan struktur bersarang digambarkan diatas. Hanya kunci-kunci yang dalam dictionary ditentukan adalah diperbaharui; sisa dari metadata tetap tidak berubah.

Untuk memindahkan barang metadata, gunakan None sebagai nilai metadata.

Code

>>> rst = GDALRaster({'width': 10, 'height': 20, 'srid': 4326})
>>> rst.metadata
{}
>>> rst.metadata = {'DEFAULT': {'OWNER': 'Django', 'VERSION': '1.0'}}
>>> rst.metadata
{'DEFAULT': {'OWNER': 'Django', 'VERSION': '1.0'}}
>>> rst.metadata = {'DEFAULT': {'OWNER': None, 'VERSION': '2.0'}}
>>> rst.metadata
{'DEFAULT': {'VERSION': '2.0'}}

vsi_bufferLink to this definition#

Sebuah bytes perwakilan dari raster ini. Mengembalikan None untuk raster-raster yang tidak disimpan dalam sistem berkas maya GDAL.

is_vsi_basedLink to this definition#

Sebuah boolean menunjukkan jika raster ini disimpan dalam sistem berkas maya GDAL.

GDALBandLink to this heading#

class GDALBandLink to this definition#

Instance-instance GDALBand tidak dibuat tegas, tetapi daripada mengambil dari obyek GDALRaster, melalui atribut bands nya. GDALBand mengandung nilai pixel sebenarnya dari raster.

descriptionLink to this definition#

Nama dari gambaran dari pita, jika ada.

widthLink to this definition#

Lebar dari pita dalam pixel (sumbu-X).

heightLink to this definition#

Lebar dari pita dalam pixel (sumbu-Y).

pixel_countLink to this definition#

Jumlah angka dari pixel dalam pita ini. Adalah setara pada width * height.

statistics(refresh=False, approximate=False)Link to this definition#

Menghitung statistik pada nilai pixel dari pita ini. Nilai kembalian adalah sebuah tuple diikuti struktur berikut: (minimum, maximum, mean, standard deviation).

Jika argumen approximate disetel menjadi True, statistik mungkin dihitung berdasarkan pada tinjauan atau subset dari ubin-ubin gambar.

Jika argumen refresh disetel menjadi True, statistik akan dihitung dari data langsung, dan cache akan diperbaharui dengan hasil.

Jika nilai cache tetap ditemukan, nilai itu dikembalikan. Untuk bentuk raster menggunakan layanan Persistent Auxiliary Metadata (PAM), statistik mungkin di cache dalam berkas bantu. Dalam beberapa kasus metadata ini mungkin diluar sinkronisasi dengan nilai pixel atau menyebabkan nilai dari panggilan sebelumnya dikembalikan yang tidak mencerminkan nilai dari argumen approximate. Dalam kasus itu, gunakan argumen resfresh untuk mendapatkan nilai pembaharuan dan menyimpan mereka dalam cache.

Untuk pita kosong (dimana semua nilai pixel adalah "no data"), semua statistik dikembalikan sebagai None.

Statistik dapat juga diambil langsung dengan mengakses milik min, max, mean, dan std.

minLink to this definition#

Nilai pixel minimal dari pita (tidak termasuk nilai "no data").

maxLink to this definition#

Nilai pixel maksimal dari pita (tidak termasuk nilai "no data").

meanLink to this definition#

Arti dari semua nilai-nilai pixel dari pita (tidak termasuk nilai "no data").

stdLink to this definition#

Penyimpangan standar dari semua nilai pixel dari pita (tidak termasuk nilai "no data").

nodata_valueLink to this definition#

Nilai "no data" untuk pita umumnya penanda khusus nilai digunakan untuk menandai pixel yang bukan data sah. Pixel tersebut harus umtumnya jangan ditampilkan, ataupun membantu menganalisa tindakan-tindakan.

Untuk menghapus nilai "no data" yang ada, setel sifat ini menjadi None (membutuhkan GDAL ≥ 2.1).

datatype(as_string=False)Link to this definition#

Jenis data terkandung dalam pita, sebagai ketetapan integer diantara 0 (Tidak diketahui) dan 11. Jika as_string adalah True, jenis data dikembalikan sebagai string dengan nilai-nilai kemungkinan sebagai berikut: GDT_Unknown, GDT_Byte, GDT_UInt16, GDT_Int16, GDT_UInt32, GDT_Int32, GDT_Float32, GDT_Float64, GDT_CInt16, GDT_CInt32, GDT_CFloat32, dan GDT_CFloat64.

color_interp(as_string=False)Link to this definition#

Tafsiran warna untuk pita, sebagai integer diantara 0 dan 16. Jika as_string adlah True, jenis data dikembalikan sebagai string dengan nilai kemungkinan berikut: GCI_Undefined, GCI_GrayIndex, GCI_PaletteIndex, GCI_RedBand, GCI_GreenBand, GCI_BlueBand, GCI_AlphaBand, GCI_HueBand, GCI_SaturationBand, GCI_LightnessBand, GCI_CyanBand, GCI_MagentaBand, GCI_YellowBand, GCI_BlackBand, GCI_YCbCr_YBand, GCI_YCbCr_CbBand, dan GCI_YCbCr_CrBand. GCI_YCbCr_CrBand juga mewakili GCI_Max karena keduanya berhubungan pada integer 16, tetapi hanya GCI_YCbCr_CrBand dikembalikan sebagai string.

data(data=None, offset=None, size=None, shape=None)Link to this definition#

Pengakses ke nilai-nilai pexel dari GDALBand. Mengembalikan larik data lengkap jika tidak ada parameter disediakan. Sebuah subset dari larik pixel dapat diminta dengan menentukan sebuah penyeimbang dan ukuran blok sebagai tuple.

Jika NumPy tersedia, data dikembalikan sebagai larik NumPy. Untuk alasan penampilan, sangat dianjurkan menggunakan NumPy.

Data ditulis pada GDALBand jika parameter data disediakan. Masukan dapat berupa satu dari jenis-jenis berikut - string paket, buffer, list, senarai, dan senarai NumPy. Jumlah barang-barang dalam masukan harus biasanya menanggapi pada jumlah angka dari pixel dalam pita, atau pada angka pixel untuk blok khusus dari nilai pixel jika parameter offset dan size disediakan.

Jika sejumlah barang dalam masukan berbeda dari ssaran blok pixel, parameter shape harus ditentukan. Shape adalah tuple yang menentukan lebar dan tinggi dari masukan data dalam pixel. Data kemudian direplikasi untuk memperbaharui nilai dari blok terpilih. Ini sangat berguna untuk mengisi seluruh pita dengan nilai tunggal, sebagai contoh.

Sebagai contoh:

Code

>>> rst = GDALRaster({'width': 4, 'height': 4, 'srid': 4326, 'datatype': 1, 'nr_of_bands': 1})
>>> bnd = rst.bands[0]
>>> bnd.data(range(16))
>>> bnd.data()
array([[ 0,  1,  2,  3],
       [ 4,  5,  6,  7],
       [ 8,  9, 10, 11],
       [12, 13, 14, 15]], dtype=int8)
>>> bnd.data(offset=(1, 1), size=(2, 2))
array([[ 5,  6],
       [ 9, 10]], dtype=int8)
>>> bnd.data(data=[-1, -2, -3, -4], offset=(1, 1), size=(2, 2))
>>> bnd.data()
array([[ 0,  1,  2,  3],
       [ 4, -1, -2,  7],
       [ 8, -3, -4, 11],
       [12, 13, 14, 15]], dtype=int8)
>>> bnd.data(data='\x9d\xa8\xb3\xbe', offset=(1, 1), size=(2, 2))
>>> bnd.data()
array([[  0,   1,   2,   3],
       [  4, -99, -88,   7],
       [  8, -77, -66,  11],
       [ 12,  13,  14,  15]], dtype=int8)
>>> bnd.data([1], shape=(1, 1))
>>> bnd.data()
array([[1, 1, 1, 1],
       [1, 1, 1, 1],
       [1, 1, 1, 1],
       [1, 1, 1, 1]], dtype=uint8)
>>> bnd.data(range(4), shape=(1, 4))
array([[0, 0, 0, 0],
       [1, 1, 1, 1],
       [2, 2, 2, 2],
       [3, 3, 3, 3]], dtype=uint8)

metadataLink to this definition#

Metadata dari pita ini. Kegunaannya mirip pada GDALRaster.metadata.

Membuat raster dari dataLink to this heading#

Bagian ini menggambarkan bagaimana membuat raster dari goresan menggunakan parameter ds_input.

Raster baru dibuat ketika dict dilewatkan pada pembangun GDALRaster. Dictionary mengandung menentukan parameter dari raster baru, seperti aslinnya, ukuran, atau sistem acuan spasial. Dictionary dapat juga mengandung data pixel dan informasi mengenai bentuk dari raster baru. Raster dihasilkan dapat karena itu berupa berdasarkan-berkas atau berdasarkan-memori, tergantung pada driver yang ditentukan.

Tidak ada standar untuk menggambarkan data raster dalam dictionary atau rasa JSON. Pengertian dari masukan dictionary pada kelas GDALRaster adalah karena itu khusus pada Django. Itu terinspirasi oleh bentuk geojson, tetapi standar geojson saat ini terbatas pada bentuk vektor.

Contoh-contoh dari menggunakan kunci berbeda ketika membuat raster dapat ditemukan dalam dokumentasi dari atribut berhubungan dan metode-metode dari kelas-kelas GDALRaster dan GDALBand.

Menggunakan Virtual Filesystem GDALLink to this heading#

GDAL mempunyai berkas sistem berdasarkan-memori dalam, yang mengizinkan memberlakukan blok-blok dari memori sebagai berkas. Itu dapat digunakan untuk membaca dan menulis obyek GDALRaster pada dan dari penyangga berkas biner.

Ini berguna dalam konteks jaringan dimana raster-raster mungkin diambil sebagai penyangga dari penyimpanan terpencil atau dikembalikan dari sebuah tampilan tanpa sedang ditulis ke cakram.

Obyek-obyek GDALRaster dibuat dalam sistem berkas maya ketika sebuah obyek bytes disediakan sebagai masukan, atau ketika jalur berkas dimulai dengan /vsimem/.

Masukan disediakan sebagai bytes harus menjadi perwakilan biner penuh dari berkas. Sebagai contoh:

# Read a raster as a file object from a remote source.
>>> from urllib.request import urlopen
>>> dat = urlopen('http://example.com/raster.tif').read()
# Instantiate a raster from the bytes object.
>>> rst = GDALRaster(dat)
# The name starts with /vsimem/, indicating that the raster lives in the
# virtual filesystem.
>>> rst.name
'/vsimem/da300bdb-129d-49a8-b336-e410a9428dad'

Untuk membuat raster berdasarkan-berkas maya dari goresan, gunakan perwakilan dictionary ds_input dan sediakan argumen name yang dimulai dengan /vsimem/ (untuk rincian dari perwakilan dictionary, lihat Membuat raster dari data). Untuk raster berdasarkan-berkas maya, atribut vsi_buffer mengembalikan perwakilan bytes dari raster.

Ini adalah bagaimana membuat raster dan mengembalikan itu sebaagi berkas dalam sebuah HttpResponse:

>>> from django.http import HttpResponse
>>> rst = GDALRaster({
...     'name': '/vsimem/temporarymemfile',
...     'driver': 'tif',
...     'width': 6, 'height': 6, 'srid': 3086,
...     'origin': [500000, 400000],
...     'scale': [100, -100],
...     'bands': [{'data': range(36), 'nodata_value': 99}]
... })
>>> HttpResponse(rast.vsi_buffer, 'image/tiff')

GDAL_LIBRARY_PATHLink to this heading#

Sebuah string nenentukan tempat dari pustaka GDAL. Khususnya, pengaturan ini hanya digunakan jika pustaka GDAL adalah dalam tempat bukan-standar (misalnya, /home/john/lib/libgdal.so).