`GDAL`__ stands for Geospatial Data Abstraction Library,\nand is a veritable "Swiss army knife" of GIS data functionality. A subset\nof GDAL is the `OGR`__ Simple Features Library, which specializes\nin reading and writing vector geographic data in a variety of standard\nformats.
\nSoláthraíonn GeodJango comhéadan Python ardleibhéil do chuid de chumais OGR, lena n-áirítear claochlú léitheoireachta agus comhordaithe sonraí spásúla veicteora agus tacaíocht íosta do ghnéithe GDAL maidir le sonraí raster (íomhá).
\n\nThe GDAL/OGR tools described here are designed to help you read in\nyour geospatial data, in order for most of them to be useful you have\nto have some data to work with. If you're starting out and don't yet\nhave any data of your own to use, GeoDjango tests contain a number of\ndata sets that you can use for testing. You can download them here:
\n$ wget https://raw.githubusercontent.com/django/django/main/tests/gis_tests/data/cities/cities.{shp,prj,shx,dbf}\n$ wget https://raw.githubusercontent.com/django/django/main/tests/gis_tests/data/rasters/raster.tif\nSonraí SonraíLink to this heading#DataSource is a wrapper for the OGR data source object that\nsupports reading data from a variety of OGR-supported geospatial file\nformats and data sources using a consistent interface. Each\ndata source is represented by a DataSource object which contains\none or more layers of data. Each layer, represented by a Layer\nobject, contains some number of geographic features (Feature),\ninformation about the type of features contained in that layer (e.g.\npoints, polygons, etc.), as well as the names and types of any\nadditional fields (Field) of data that may be associated with\neach feature in that layer.
Ní theastaíonn ach paraiméadar amháin ar an tógálaí do DataSource`: cosán an chomhaid is mian leat a léamh. Mar sin féin, tacaíonn OGR le réimse foinsí sonraí níos casta, lena n-áirítear bunachair sonraí, ar féidir rochtain a fháil orthu trí shreang ainm speisialta a rith in ionad cosán. Le haghaidh tuilleadh faisnéise, féach an doiciméadú `OGR Vector Formats`__. Tugann maoin: Attr: ainm de shampla Datasource ainm OGR an fhoinse sonraí bunúsach atá á úsáid aige.
Ligeann an paraiméadar roghnach “ionchódú” duit ionchódú neamhchaighdeánach de na teaghráin sa fhoinse a shonrú. Is gnách go mbíonn sé seo úsáideach nuair a fhaigheann tú eisceachtaí DjangounicodeDecodeError agus tú ag léamh luachanna réimse.
Nuair a bheidh do Dataource` cruthaithe agat, is féidir leat a fháil amach cé mhéad sraitheanna sonraí atá ann trí rochtain a fháil ar an maoin: attr: layer_count, nó (go coibhéiseach) tríd an bhfeidhm `len () ``a úsáid. Le haghaidh faisnéise maidir le rochtain a fháil ar na sraitheanna sonraí féin, féach an chéad chuid eile:
\n>>> from django.contrib.gis.gdal import DataSource\n>>> ds = DataSource("/path/to/your/cities.shp")\n>>> ds.name\n'/path/to/your/cities.shp'\n>>> ds.layer_count # This file only contains one layer\n1\nTugann sé líon na sraitheanna san fhoinse sonraí ar ais.
\nTugann ainm na foinse sonraí ar ais.
\nIs é Layer fillteán do chiseal sonraí i réad DataSource. Ní chruthaíonn tú réad Layer go díreach riamh. Ina áit sin, aisghabhann tú iad ó a: class: DataSource réad, atá go bunúsach ina choimeádán caighdeánach Python de rudaí Layer`. Mar shampla, is féidir leat rochtain a fháil ar chiseal ar leith trína innéacs (m.sh. `ds [0] ``chun rochtain a fháil ar an gcéad chiseal), nó is féidir leat athrá thar na sraitheanna go léir sa choimeádán i lúb ``for. Feidhmíonn an Layer féin mar choimeádán do ghnéithe geoiméadracha.
De ghnáth, bíonn an cineál céanna céanna ag na gnéithe go léir i gciseal áirithe. Is é maoin: attr: geom_type ciseal ná: class: ogrGeomType a aithníonn an cineál gné. Is féidir linn é a úsáid chun roinnt faisnéise bunúsach a phriontáil faoi gach ciseal in a:class: DataSource:
\n>>> for layer in ds:\n... print('Layer "%s": %i %ss' % (layer.name, len(layer), layer.geom_type.name))\n...\nLayer "cities": 3 Points\nTá an t-aschur sampla ó fhoinse sonraí na gcathracha, luchtaithe thuas, ina léir go bhfuil ciseal amháin, ar a dtugtar ``"cathracha” ``, ina bhfuil trí ghné phointe ann. Ar mhaithe le simplíocht, glacann na samplaí thíos leis gur stóráil tú an ciseal sin san athróg ``sraith ``:
\n>>> layer = ds[0]\nTugann ainm an chiseal seo ar ais san fhoinse sonraí.
\n>>> layer.name\n'cities'\nTugann sé líon na ngnéithe sa chiseal ar ais. Mar an gcéanna le len (ciseal) `:
\n>>> layer.num_feat\n3\nTugann sé cineál geoiméadrach an chiseal ar ais, mar réad: class: ogrGeomType:
\n>>> layer.geom_type.name\n'Point'\nTugann sé líon na réimsí sa chiseal ar ais, ie líon na réimsí sonraí a bhaineann le gach gné sa chiseal:
\n>>> layer.num_fields\n4\nTugann liosta ar ais d'ainmneacha gach ceann de na réimsí sa chiseal seo:
\n>>> layer.fields\n['Name', 'Population', 'Density', 'Created']\nTugann liosta de na cineálacha sonraí gach ceann de na réimsí sa chiseal seo ar ais. Is fo-aicmí iad seo de Field, a phléitear thíos:
\n>>> [ft.__name__ for ft in layer.field_types]\n['OFTString', 'OFTReal', 'OFTReal', 'OFTDate']\nTugann liosta de na leithead réimse uasta do gach ceann de na réimsí sa chiseal seo ar ais:
\n>>> layer.field_widths\n[80, 11, 24, 10]\nTugann liosta de na cruinneas uimhriúla ar ais do gach ceann de na réimsí sa chiseal seo. Tá sé seo gan brí (agus socraithe go nialas) do réimsí neamh-uimhriúla:
\n>>> layer.field_precisions\n[0, 0, 15, 0]\nTugann sé ar ais méid spásúil an chiseal seo, mar réad an:class: Envelope:
\n>>> layer.extent.tuple\n(-104.609252, 29.763374, -95.23506, 38.971823)\nMaoin a thugann air:class: spatialReference a bhaineann leis an gciseal seo:
\n>>> print(layer.srs)\nGEOGCS["GCS_WGS_1984",\n DATUM["WGS_1984",\n SPHEROID["WGS_1984",6378137,298.257223563]],\n PRIMEM["Greenwich",0],\n UNIT["Degree",0.017453292519943295]]\nMura bhfuil aon fhaisnéis tagartha spásúil ag an:class: Layer a bhaineann leis, cuirtear ``None ``ar ais.
\nMaoin a d'fhéadfaí a úsáid chun scagaire spásúil a aisghabháil nó a shocrú don chiseal seo. Ní féidir scagaire spásúil a shocrú ach amháin le sampla: class: OgrGeometry, méid 4 tuipéil, nó None. Nuair a bheidh sé socraithe le rud éigin seachas ``None ``, ní thabharfar ach gnéithe a thrasnaíonn an scagaire ar ais agus iad ag athrú thar an gciseal:
>>> print(layer.spatial_filter)\nNone\n>>> print(len(layer))\n3\n>>> [feat.get("Name") for feat in layer]\n['Pueblo', 'Lawrence', 'Houston']\n>>> ks_extent = (-102.051, 36.99, -94.59, 40.00) # Extent for state of Kansas\n>>> layer.spatial_filter = ks_extent\n>>> len(layer)\n1\n>>> [feat.get("Name") for feat in layer]\n['Lawrence']\n>>> layer.spatial_filter = None\n>>> len(layer)\n3\nModh a thugann liosta de luachanna réimse ar leith ar fáil do gach gné sa chiseal:
\n>>> layer.get_fields("Name")\n['Pueblo', 'Lawrence', 'Houston']\nModh a thugann liosta ar ais ina bhfuil geoiméadacht gach gné sa chiseal. Má tá an argóint roghnach geos socraithe go True ansin déantar na geoiméadrachtaí a thiontú go rudaí:class: ~django.contrib.gis.geos.geosgeometry. Seachas sin, cuirtear ar ais iad mar: class: ogrGeometry rudaí:
>>> [pt.tuple for pt in layer.get_geoms()]\n[(-104.609252, 38.255001), (-95.23506, 38.971823), (-95.363151, 29.763374)]\nReturns a boolean indicating whether this layer supports the given\ncapability (a string). Examples of valid capability strings include:\n'RandomRead', 'SequentialWrite', 'RandomWrite',\n'FastSpatialFilter', 'FastFeatureCount', 'FastGetExtent',\n'CreateField', 'Transactions', 'DeleteFeature', and\n'FastSetNextByIndex'.
GnéitheLink to this heading#Fillteann Feature gné OGR. Ní chruthaíonn tú réad Feature go díreach riamh. Ina áit sin, aisghabhann tú iad ó réad a: class: Layer. Is éard atá i ngach gné geoiméadracht agus sraith réimsí ina bhfuil airíonna breise. Tá geoiméadracht réimse inrochtana tríd a mhaoin geom, a thugann ruda:class: ogrGeometry ar ais. Iompraíonn Feature cosúil le coimeádán caighdeánach Python dá réimsí, a thugann sé ar ais mar ruda:class: Field: is féidir leat rochtain a fháil ar réimse go díreach trína innéacs nó ainm, nó is féidir leat athrá thar réimsí gné, m.sh. i lúb for`.
Tugann sé an geoiméadracht don ghné seo ar ais, mar réad ``Ogrgeoiméadr`:
\n>>> city.geom.tuple\n(-104.609252, 38.255001)\nModh a thugann luach an réimse tugtha ar ais (sonraithe de réir ainm) don ghné seo, ní réad fillte ``Réimse ``:
\n>>> city.get("Population")\n102121\nTugann sé an cineál céimeadra don ghné seo ar ais, mar réad: class: ogrGeomType. Beidh sé seo mar an gcéanna do gach gné i gciseal ar leith agus tá sé coibhéiseach leis an maoin: attr: Layer.geom_TYPE den réad :class: Layer as a tháinig an ghné.
\nTugann sé líon na réimsí sonraí a bhaineann leis an ngné ar ais. Beidh sé seo mar an gcéanna do gach gné i gciseal ar leith agus tá sé coibhéiseach leis an maoin: attr: Layer.num_Fields den réad: Class: Layer as a tháinig an ghné.
\nTugann liosta ar ais d'ainmneacha na réimsí sonraí a bhaineann leis an ngné. Beidh sé seo mar an gcéanna do gach gné i gciseal ar leith agus tá sé coibhéiseach leis an maoin: attr: Layer.Fields den réad: Class: Layer as a tháinig an ghné.
\nTugann an t-aitheantas gné ar ais laistigh den chiseal:
\n>>> city.fid\n0\nTugann ainm an: class: Layer as a tháinig an ghné ar ais. Beidh sé seo mar an gcéanna le haghaidh gach gné i gciseal ar leith:
\n>>> city.layer_name\n'cities'\nModh a thugann innéacs an ainm réimse tugtha ar ais. Beidh sé seo mar an gcéanna do gach gné i gciseal ar leith:
\n>>> city.index("Population")\n1\nRéimseLink to this heading#Tugann ainm an réimse seo ar ais:
\n>>> city["Name"].name\n'Name'\nTugann sé an cineál OGR den réimse seo ar ais, mar shláimhir. Déanann an foclóir FIELD_CLASSES` na luachanna seo a léarscáil ar fho-aicmí Field:
>>> city["Density"].type\n2\nTugann teaghrán ar ais le hainm an chineál sonraí an réimse seo:
\n>>> city["Name"].type_name\n'String'\nTugann luach an réimse seo ar ais. Tugann an rang Field féin an luach ar ais mar shreang, ach filleann gach fo-aicme an luach sa fhoirm is oiriúnaí:
>>> city["Population"].value\n102121\nTugann sé leithead an réimse seo ar ais:
\n>>> city["Name"].width\n80\nTugann cruinneas uimhriúil an réimse seo ar ais. Tá sé seo gan brí (agus socraithe go nialas) do réimsí neamh-uimhriúla:
\n>>> city["Density"].precision\n15\nTugann luach an réimse ar ais mar dhúbailte (snámhphointe):
\n>>> city["Density"].as_double()\n874.7\nTugann luach an réimse ar ais mar shláimhir:
\n>>> city["Population"].as_int()\n102121\nTugann luach an réimse ar ais mar shreang:
\n>>> city["Name"].as_string()\n'Pueblo'\nTugann luach an réimse ar ais mar thiúpla de chomhpháirteanna dáta agus ama:
\n>>> city["Created"].as_datetime()\n(c_long(1999), c_long(5), c_long(23), c_long(0), c_long(0), c_long(0), c_long(0))\nTiománaLink to this heading#Úsáidtear an rang Tiomána go hinmheánach chun tiománaí OGR:Class: DataSource a fhilleadh.
Filleann líon na dtiománaithe veicteora OGR atá cláraithe faoi láthair.
\nOGRGeometry objects share similar functionality with\nGEOSGeometry objects and are thin wrappers\naround OGR's internal geometry representation. Thus, they allow for more\nefficient access to data when using DataSource. Unlike its GEOS\ncounterpart, OGRGeometry supports spatial reference systems and\ncoordinate transformation:
>>> from django.contrib.gis.gdal import OGRGeometry\n>>> polygon = OGRGeometry("POLYGON((0 0, 5 0, 5 5, 0 5))")\nIs fillteán é an réad seo don rang Geoiméadracht OGR `__. Déantar na rudaí seo a thionscnamh go díreach ón bparaiméadar ``geom_input` a thugtar, ar d'fhéadfadh a bheith ina sreang ina bhfuil WKT, HEX, GeoJSON, maolán ``ina bhfuil sonraí WKB, nó ruda:class: `ogrGeomType. Cuirtear na rudaí seo ar ais freisin ón tréith: :class: Feature.geom, agus sonraí veicteora á léamh ó:class: Layer (atá ina chuid de a:class: DataSource).
\nTógann sé an:aicme: OgGeoiméadrach ón sreang GML tugtha.
\nTógann a: aicme: Polygon ón mbosca teorainn a thugtar (4-tuple).
\nTugann sé ar ais líon na bpointí in a:aicme: Linestring, líon na bhfáinní in a:aicme: Polygon, nó líon na ngeoiméadrachtaí in a:class: GeometryCollection. Ní bhaineann le cineálacha geoiméadrachta eile.
\nAthraigh thar na pointí in a: aicme: Linestring, na fáinní i a: aicme: Polygon, nó na geoiméadrachtaí in a:class: GeometryCollection. Ní bhaineann le cineálacha geoiméadrachta eile.
\nTugann an pointe ar ais ag an innéacs sonraithe le haghaidh a: aicme: LíneString, an fáinne istigh ag an innéacs sonraithe do a:class: Polygon, nó an geoiméadra ag an innéacs sonraithe in a:class: GeometryCollection. Ní bhaineann le cineálacha geoiméadrachta eile.
\nTugann sé líon toisí comhordaithe an ghéiméadrachta ar ais, ie 0 do phointí, 1 do línte, agus mar sin de:
\n>>> polygon.dimension\n2\nBoolean a léiríonn an bhfuil comhordanáidí Z ag an gcéimseadra seo.
\nModh a chuireann nó a bhaineann an toise comhordaithe Z.
\n>>> p = OGRGeometry("POINT (1 2 3)")\n>>> p.is_3d\nTrue\n>>> p.set_3d(False)\n>>> p.wkt\n"POINT (1 2)"\nBoolean a léiríonn an bhfuil comhordanáidí M ag an gcéimseadra seo.
\nModh chun an toise comhordaithe M a chur leis nó a bhaint.
\n>>> p = OGRGeometry("POINT (1 2)")\n>>> p.is_measured\nFalse\n>>> p.set_measured(True)\n>>> p.wkt\n"POINT M (1 2 0)"\nTugann sé líon na n-eilimintí sa geoiméadra seo ar ais:
\n>>> polygon.geom_count\n1\nA boolean indicating if this geometry is or contains a curve geometry.
\nReturns a linear version of the geometry. If no conversion can be made, the\noriginal geometry is returned.
\nReturns a curved version of the geometry. If no conversion can be made, the\noriginal geometry is returned.
\nTugann sé líon na bpointí a úsáidtear chun cur síos a dhéanamh ar an geoiméad
\n>>> polygon.point_count\n4\nAlias le haghaidh: attr: point_count.
\nAlias le haghaidh: attr: point_count.
\nTugann sé an cineál céimeadra seo ar ais, mar réad: class: ogrGeomType.
\nTugann ainm an chineál céiméadra seo ar ais:
\n>>> polygon.geom_name\n'POLYGON'\nTugann sé limistéar an geoiméadra seo ar ais, nó 0 le haghaidh geoiméadraí nach bhfuil limistéar ann:
\n>>> polygon.area\n25.0\nTugann clúdach an ghéiméadracht seo ar ais, mar réad: aicme: Envelop.
\nTugann clúdach an ghéiméadracht seo ar ais mar 4-tuple, in ionad mar réad an:class: Envelope:
\n>>> point.extent\n(0.0, 0.0, 5.0, 5.0)\nThis property controls the spatial reference for this geometry, or\nNone if no spatial reference system has been assigned to it.\nIf assigned, accessing this property returns a SpatialReference\nobject. It may be set with another SpatialReference object,\nor any input that SpatialReference accepts. Example:
>>> city.geom.srs.name\n'GCS_WGS_1984'\nReturns or sets the spatial reference identifier corresponding to\nSpatialReference of this geometry. Returns None if\nthere is no spatial reference information associated with this\ngeometry, or if an SRID cannot be determined.
Tuairisceáin a:class: ~django.contrib.gis.geos.geosgeometry réad a fhreagraíonn don ghéiméadracht seo.
\nTugann sé léiriú teaghrán den ghéiméadracht seo ar ais i bhformáid GML:
\n>>> OGRGeometry("POINT(1 2)").gml\n'<gml:Point><gml:coordinates>1,2</gml:coordinates></gml:Point>'\nTugann sé léiriú teaghrán den ghéiméadracht seo ar ais i bhformáid HEX WKB:
\n>>> OGRGeometry("POINT(1 2)").hex\n'0101000000000000000000F03F0000000000000040'\nFilleann sé léiriú teaghrán den ghéimseata seo i bhformáid JSON:
\n>>> OGRGeometry("POINT(1 2)").json\n'{ "type": "Point", "coordinates": [ 1.000000, 2.000000 ] }'\nFilleann sé léiriú teaghrán den ghéiméadracht seo i bhformáid KML.
\nTugann sé ar ais méid an maoláin WKB a theastaíonn chun léiriú WKB a shealbhú den ghéiméadracht seo:
\n>>> OGRGeometry("POINT(1 2)").wkb_size\n21\nTugann sé “maolán” ar ais ina bhfuil léiriú WKB den ghéiméadracht seo.
\nFilleann sé léiriú teaghrán den ghéiméadracht seo i bhformáid WKT.
\nTugann ionadaíocht EWKT an geoiméadra seo ar ais.
\nFilleann clón nua:class: ogrGeometry den réad geoiméadrach seo.
\nMá tá aon fáinní laistigh den ghéiméadracht seo nár dúnadh, déanfaidh an gnáthamh seo amhlaidh tríd an bpointe tosaigh a chur leis an deireadh:
\n>>> triangle = OGRGeometry("LINEARRING (0 0,0 1,1 0)")\n>>> triangle.close_rings()\n>>> triangle.wkt\n'LINEARRING (0 0,0 1,1 0,0 0)'\nAthraíonn sé an geoiméadracht seo go córas tagartha spásúil difriúil. Féadfaidh sé a: aicme: CoordTransform réad, a:class: SpatialReference a thógáil, nó aon ionchur eile a nglactar leis ar:class: SpatialReference (lena n-áirítear tagairt spásúil WKT agus teaghráin PROJ, nó SRID sláimhir).
\nDe réir réamhshocraithe ní thugtar aon rud ar ais agus déantar an geoiméadracht a athrú go Mar sin féin, má tá an eochairfhocal clone socraithe go True ansin cuirtear clón claochlaithe den ghéimseadracht seo ar ais ina ionad.
Tugann sé ar ais True má thrasnaíonn an geoiméadacht seo an ceann eile, ar shlí eile filleann sé False.
Tugann sé ar ais True má tá an geoiméadacht seo coibhéiseach leis an gceann eile, seachas sin filleann sé False.
Tugann sé ar ais True má tá an geoiméadacht seo dícheangailte go spásúil leis an gceann eile (i.e. ní thrasnaíonn sé), ar shlí eile filleann sé False.
Tugann sé True má chuireann an geoiméadacht seo i dteagmháil leis an gceann eile, seachas sin filleann sé False.
Tugann sé ar ais True má thrasnaíonn an geoiméadacht seo an ceann eile, ar shlí eile filleann sé False.
Tugann sé True má tá an geoiméadacht seo laistigh den chéad cheann eile, seachas sin filleann sé False.
Tugann sé True má tá an ceann eile sa geoiméadacht seo, ar shlí eile filleann sé False.
Tugann sé ar ais True má fhorluíonn an geoiméadacht seo an ceann eile, ar shlí eile filleann sé False.
Teorainn an ghéiméadracht seo, mar réad nua:class: OgrGeometry.
\nAn polagán doimhneach is lú ina bhfuil an geoiméadacht seo, mar réad nua:class: ogrGeometry.
\nFilleann sé an réigiún ina bhfuil difríocht an geoiméadra seo agus an ceann eile, mar réad nua:class: ogrGeometry.
\nTugann sé ar ais an réigiún ina bhfuil trasna an ghéiméadracht seo agus an ceann eile, mar réad nua:class: ogrGeometry.
\nTugann sé ar ais an réigiún ina bhfuil difríocht shioméadrach an ghéiméadracht seo agus an ceann eile, mar réad nua:class: ogrGeometry.
\nTugann sé ar ais an réigiún ina bhfuil aontas an geoiméadair seo agus an ceann eile, mar réad nua:class: ogrGeometry.
\nTuairisceáin a: aicme: Point a léiríonn lárnach an geoiméadair seo.
\nTugann comhordanáidí geoiméadracht pointe ar ais mar thiúpla, comhordanáidí céiméadra líne mar thiúpla de thiúpla, agus mar sin de:
\n>>> OGRGeometry("POINT (1 2)").tuple\n(1.0, 2.0)\n>>> OGRGeometry("LINESTRING (1 2,3 4)").tuple\n((1.0, 2.0), (3.0, 4.0))\nAinm le haghaidh: attr: tuple.
\nTugann comhordú X an phointe seo ar ais:
\n>>> OGRGeometry("POINT (1 2)").x\n1.0\nTugann comhordú Y an phointe seo ar ais:
\n>>> OGRGeometry("POINT (1 2)").y\n2.0\nTugann comhordú Z an phointe seo ar ais, nó None mura bhfuil comhordú Z ag an bpointe:
>>> OGRGeometry("POINT (1 2 3)").z\n3.0\nTugann comhordú M an phointe seo ar ais, nó None mura bhfuil comhordú M ag an bPointe:
>>> OGRGeometry("POINT ZM (1 2 3 4)").m\n4.0\nTugann liosta de chomhordanáidí X ar ais sa líne seo:
\n>>> OGRGeometry("LINESTRING (1 2,3 4)").x\n[1.0, 3.0]\nTugann liosta de chomhordanáidí Y ar ais sa líne seo:
\n>>> OGRGeometry("LINESTRING (1 2,3 4)").y\n[2.0, 4.0]\nTugann liosta de chomhordanáidí Z ar ais sa líne seo, nó ``None ``mura bhfuil comhordanáidí Z ag an líne:
\n>>> OGRGeometry("LINESTRING (1 2 3,4 5 6)").z\n[3.0, 6.0]\nTugann liosta de chomhordanáidí M sa líne seo nó None mura bhfuil comhordanáidí M ag an líne:
>>> OGRGeometry("LINESTRING(0 1 2 10, 1 2 3 11, 2 3 4 12)").m\n[10.0, 11.0, 12.0]\nTugann an bhlaosc nó an fáinne taobh amuigh den pholagán seo ar ais, mar gheoiméadra Línear.
Ainm le haghaidh: attr: shell.
\nCuireann sé geoiméadra leis an mbailiúchán geoiméad Ní bhaineann le cineálacha geoiméadrachta eile.
\nOgrGeomTypeLink to this heading#Ceadaíonn an rang seo cineál geoiméadrachta OGR a léiriú ar aon cheann de bhealaí éagsúla:
\n>>> from django.contrib.gis.gdal import OGRGeomType\n>>> gt1 = OGRGeomType(3) # Using an integer for the type\n>>> gt2 = OGRGeomType("Polygon") # Using a string\n>>> gt3 = OGRGeomType("POLYGON") # It's case-insensitive\n>>> print(gt1 == 3, gt1 == "Polygon") # Equivalence works w/non-OGRGeomType objects\nTrue True\nTugann foirm teaghrán gearr-láimhe de chineál Geoimseachta OGR ar ais:
\n>>> gt1.name\n'Polygon'\nTugann an uimhir a fhreagraíonn don chineál geoiméadachta OGR ar ais:
\n>>> gt1.num\n3\nFilleann sé cineál réimse Django (fo-aicme de GeometryField) le húsáid chun an cineál OGR seo a stóráil, nó ``None ``mura bhfuil aon chineál Django oiriúnach ann:
\n>>> gt1.django\n'PolygonField'\n`ImbléadLink to this heading#Léiríonn sé struchtúr Clúdach OGR ina bhfuil na comhordanáidí X, Y íosta agus uasta do bhosca teorainn dronuilleogach. Tá ainmniú na n-athróg comhoiriúnach le struchtúr Clúdach OGR C.
\nLuach an chomhordaithe X íosta.
\nLuach an chomhordaithe X uasta.
\nLuach an chomhordaithe íosta Y.
\nLuach an chomhordaithe uasta Y.
\nAn comhordú uachtarach ar dheis, mar tuple.
\nAn comhordú ar chlé íochtarach, mar chlúdach.
\nTuple a léiríonn an clúdach.
\nSreang a léiríonn an clúdach seo mar pholgún i bhformáid WKT.
\nTagairt spáisLink to this heading#Cuirtear rudaí tagartha spásúla a thionscnamh ar an srs_input` a thugtar, a d'fhéadfadh a bheith ar cheann de na nithe seo a leanas:
\nTéacs Aitheanta OGC (WKT) (sreang)
Cód EPSG (sláimhir nó sreang)
Proj teaghrán
Teagán gearrthréimhe do chaighdeáin aitheanta ('WGS84', WGS72'`, ``NAD27'`, ``NAD83')
Sampla:
\n>>> wgs84 = SpatialReference("WGS84") # shorthand string\n>>> wgs84 = SpatialReference(4326) # EPSG code\n>>> wgs84 = SpatialReference("EPSG:4326") # EPSG string\n>>> proj = "+proj=longlat +ellps=WGS84 +datum=WGS84 +no_defs "\n>>> wgs84 = SpatialReference(proj) # PROJ string\n>>> wgs84 = SpatialReference("""GEOGCS["WGS 84",\n... DATUM["WGS_1984",\n... SPHEROID["WGS 84",6378137,298.257223563,\n... AUTHORITY["EPSG","7030"]],\n... AUTHORITY["EPSG","6326"]],\n... PRIMEM["Greenwich",0,\n... AUTHORITY["EPSG","8901"]],\n... UNIT["degree",0.01745329251994328,\n... AUTHORITY["EPSG","9122"]],\n... AUTHORITY["EPSG","4326"]]""") # OGC WKT\nTugann sé luach an nód tréith teaghrán a thugtar, ``None ``mura bhfuil an nód ann. Is féidir le tuple a ghlacadh mar pharaiméadar freisin, (sprioc, leanbh), áit a bhfuil an leanbh innéacs an tréith sa WKT. Mar shampla:
\n>>> wkt = 'GEOGCS["WGS 84", DATUM["WGS_1984, ... AUTHORITY["EPSG","4326"]]'\n>>> srs = SpatialReference(wkt) # could also use 'WGS84', or 4326\n>>> print(srs["GEOGCS"])\nWGS 84\n>>> print(srs["DATUM"])\nWGS_1984\n>>> print(srs["AUTHORITY"])\nEPSG\n>>> print(srs["AUTHORITY", 1]) # The authority value\n4326\n>>> print(srs["TOWGS84", 4]) # the fourth value in this wkt\n0\n>>> print(srs["UNIT|AUTHORITY"]) # For the units authority, have to use the pipe symbol.\nEPSG\n>>> print(srs["UNIT|AUTHORITY", 1]) # The authority value for the units\n9122\nAn luach tréithe don spriocnód tugtha (m.sh. ``PROJCS'`). Sonraíonn an eochairfhocal innéacs den nód linbh le filleadh.
\nTugann ainm an údaráis ar ais don sprioc-nód sreangán a thugtar.
\nTugann an cód údaráis ar ais don sprioc-nód sreangán a thugtar.
\nTugann clón den réad tagartha spásúil seo ar ais.
\nDéanann an modh seo iniúchadh ar WKT an SpatialReference seo agus cuirfidh sé nóid údaráis EPSG leis nuair a bhíonn aitheantóir EPSG infheidhme.
Déanann an Tagairt spásúil seo a mhorgáil ó fhormáid ESRI go EPSG
\nMorphaíonn an spásúil seoTagairt d'fhormáid ESRI.
\nSeiceálacha chun a fháil amach an bhfuil an tagairt spásúil a thugtar bailí, mura n-ardófar eisceacht.
\nTagairt spásúil a iompórtáil ó chód EPSG.
\nTagairt spásúil a iompórtáil ó sreang PROJ.
\nTagairt spásúil a iompórtáil ó WKT.
\nTagairt spásúil a iompórtáil ó XML.
\nTugann ainm an Tagartha Spásúil seo ar ais.
\nTugann an SRID d'údarás barrleibhéil ar ais, nó None mura bhfuil sainmhínithe.
Tugann ainm na n-aonad líneach ar ais.
\nTugann luach na n-aonad líneach ar ais.
\nTugann ainm na n-aonad uilleach ar ais.”
\nTugann luach na n-aonad uilleach ar ais.
\nFilleann sé 2-tuple de luach na haonaid agus ainm na n-aonaid agus cinneoidh sé go huathoibríoch an gcuirfear na haonaid líneacha nó uilleacha ar ais.
\nFilleann sé tuple de na paraiméadair ellipsoid don tagairt spásúil seo: (ais semimajor, ais semiminor, agus comhréiteach inbhéartha).
\nFilleann ais leathmhór an ellipsoid don tagairt spásúil seo.
\nFilleann ais leathbheag an ellipsoid don tagairt spásúil seo.
\nTugann sé comhréiteach inbhéartha an ellipsoid ar ais don tagairt spásúil seo.
\nTugann sé ar ais True má tá an tagairt spásúil seo geografach (is é `GEOGCS ``fréimhnód).
Tugann sé ar ais True má tá an tagairt spásúil seo áitiúil (is é LOCAL_CS` fréimhe ná LOCAL_CS).
Tugann sé ar ais True más córas comhordaithe réamh-mheasta é an tagairt spásúil seo (is é `PROJCS ``nód fréimhe).
Tugann sé ionadaíocht WKT ar an tagairt spásúil seo ar ais.
\nTugann sé ionadaíocht 'deas' an WKT ar ais.
\nTugann sé ionadaíocht PROJ ar ais don tagairt spásúil seo.
\nAlias le haghaidh: attr: spatialReference.proj.
\nTugann sé ionadaíocht XML an tagartha spásúil seo ar ais.
\nCoordTransformLink to this heading#Léiríonn sé athrú córais chomhordaithe. Tosaítear é le dhá: aicme: SpatialReference, a léiríonn na córais comhordaithe foinse agus spriocchórais, faoi seach. Ba chóir na rudaí seo a úsáid agus an claochlú comhordaithe céanna á ndéanamh arís agus arís eile ar geoiméadraí
\n>>> ct = CoordTransform(SpatialReference("WGS84"), SpatialReference("NAD83"))\n>>> for feat in layer:\n... geom = feat.geom # getting clone of feature geometry\n... geom.transform(ct) # transforming\n...\nGdalrasterLink to this heading#GDALRaster is a wrapper for the GDAL raster source object that\nsupports reading data from a variety of GDAL-supported geospatial file formats\nand data sources using a consistent interface. Each data source is represented\nby a GDALRaster object which contains one or more layers of data named\nbands. Each band, represented by a GDALBand object, contains\ngeoreferenced image data. For example, an RGB image is represented as three\nbands: one for red, one for green, and one for blue.
Glacann an tógálaí le haghaidh Gdalraster dhá pharaiméadar. Sainmhíníonn an chéad pharaiméadar an fhoinse raster, agus sainmhíníonn an dara paraiméadar an gcaithfear raster a oscailt i mód scríbhneoireachta. Maidir le rasters nua-chruthaithe, déantar neamhaird ar an dara paraiméadar agus cruthaítear an raster nua i gcónaí i mód scríbhneoireachta.
Is féidir leis an gcéad pharaiméadar trí fhoirm a ghlacadh: teaghrán nó:class: ~pathlib.path a léiríonn cosán comhaid (córas comhaid nó córas comhaid fíorúil GDAL), foclóir le luachanna a shainníonn raster nua, nó réad beáit a léiríonn comhad raster.
\nMás cosán comhad é an t-ionchur, osclaítear an raster as sin. Más sonraí amh i bhfoclóir iad an t-ionchur, teastaíonn na paraiméadair leithead`, `airde, agus srid. Más réad bytes é an t-ionchur, osclófar é ag baint úsáide as córas comhaid fíorúil GDAL.
Le haghaidh tuairisc mhionsonraithe ar conas rasters a chruthú ag baint úsáide as ionchur foclóra, féach:ref: gdal-raster-ds-input. Le haghaidh tuairisc mhionsonraithe ar conas rasters a chruthú sa chóras comhaid fíorúil, féach:ref: gdal-raster-vsimem.
\nTaispeánann an sampla seo a leanas conas is féidir rasters a chruthú ó fhoinsí ionchuir éagsúla (ag baint úsáide as na sonraí samplacha ó na tástálacha GeoDjango; féach freisin roinn:ref: gdal_sample_data).
\n>>> from django.contrib.gis.gdal import GDALRaster\n>>> rst = GDALRaster("/path/to/your/raster.tif", write=False)\n>>> rst.name\n'/path/to/your/raster.tif'\n>>> rst.width, rst.height # This file has 163 x 174 pixels\n(163, 174)\n>>> rst = GDALRaster(\n... { # Creates an in-memory raster\n... "srid": 4326,\n... "width": 4,\n... "height": 4,\n... "datatype": 1,\n... "bands": [\n... {\n... "data": (2, 3),\n... "offset": (1, 1),\n... "size": (2, 2),\n... "shape": (2, 1),\n... "nodata_value": 5,\n... }\n... ],\n... }\n... )\n>>> rst.srs.srid\n4326\n>>> rst.width, rst.height\n(4, 4)\n>>> rst.bands[0].data()\narray([[5, 5, 5, 5],\n [5, 2, 3, 5],\n [5, 2, 3, 5],\n [5, 5, 5, 5]], dtype=uint8)\n>>> rst_file = open("/path/to/your/raster.tif", "rb")\n>>> rst_bytes = rst_file.read()\n>>> rst = GDALRaster(rst_bytes)\n>>> rst.is_vsi_based\nTrue\n>>> rst.name # Stored in a random path in the vsimem filesystem.\n'/vsimem/da300bdb-129d-49a8-b336-e410a9428dad'\nAinm na foinse atá coibhéiseach leis an gcosán comhaid ionchuir nó an t-ainm a chuirtear ar fáil nuair a chuirtear isteach.
\n>>> GDALRaster({"width": 10, "height": 10, "name": "myraster", "srid": 4326}).name\n'myraster'\nAinm an tiománaí GDAL a úsáidtear chun an comhad ionchuir a láimhseáil. Maidir le Gdalrasters a cruthaíodh ó chomhad, braithtear an cineál tiománaí go huathoibríoch. Is raster in-chuimhne é cruthú rasters ón tús de réir réamhshocraithe (MEM'), ach is féidir é a athrú de réir mar is gá. Mar shampla, bain úsáid as GTIFF le haghaidh comhad GeoTiff. Le haghaidh liosta de chineálacha comhaid, féach freisin an liosta `GDAL Raster Formats`__.
Cruthaítear raster in-chuimhne tríd an sampla seo a leanas:
\n>>> GDALRaster({"width": 10, "height": 10, "srid": 4326}).driver.name\n'MEM'\nCruthaítear raster GeoTIFF bunaithe ar chomhad tríd an sampla seo a leanas:
\n>>> import tempfile\n>>> rstfile = tempfile.NamedTemporaryFile(suffix=".tif")\n>>> rst = GDALRaster(\n... {\n... "driver": "GTiff",\n... "name": rstfile.name,\n... "srid": 4326,\n... "width": 255,\n... "height": 255,\n... "nr_of_bands": 1,\n... }\n... )\n>>> rst.name\n'/tmp/tmp7x9H4J.tif' # The exact filename will be different on your computer\n>>> rst.driver.name\n'GTiff'\nLeithead na foinse i bpicteilíní (X-ais).
\n>>> GDALRaster({"width": 10, "height": 20, "srid": 4326}).width\n10\nAirde na foinse i bpicteilíní (ais Y).
\n>>> GDALRaster({"width": 10, "height": 20, "srid": 4326}).height\n20\nCóras tagartha spásúil an raster, mar shampla a:class: SpatialReference. Is féidir an SRS a athrú tríd é a shocrú go dtí: class: SpatialReference eile nó aon ionchur a ghlacann an tógálaí:class: SpatialReference a sholáthar.
\n>>> rst = GDALRaster({"width": 10, "height": 20, "srid": 4326})\n>>> rst.srs.srid\n4326\n>>> rst.srs = 3086\n>>> rst.srs.srid\n3086\nAitheantóir an Chórais Tagartha Spásúil (SRID) an raster. Is aicearra í an maoin seo chun an SRID a fháil nó a shocrú tríd an tréith: attr: srs.
\n>>> rst = GDALRaster({"width": 10, "height": 20, "srid": 4326})\n>>> rst.srid\n4326\n>>> rst.srid = 3086\n>>> rst.srid\n3086\n>>> rst.srs.srid # This is equivalent\n3086\nÚsáidtear an maitrís claochlaithe affine chun an fhoinse a ghearradh, mar thiúpla de sé chomhéifeacht a mhapálann comhordanáidí picteilín/líne isteach i spás georeferencithe ag baint úsáide as an gcaidreamh seo a leanas:
\nXgeo = GT(0) + Xpixel * GT(1) + Yline * GT(2)\nYgeo = GT(3) + Xpixel * GT(4) + Yline * GT(5)\nIs féidir na luachanna céanna a aisghabháil trí rochtain a fháil ar airíonna: attr: origin (innéacsanna 0 agus 3), :attr: scale (innéacsanna 1 agus 5) agus:attr: sque (innéacsanna 2 agus 4).
\nIs é an réamhshocrú [0.0, 1.0, 0.0, 0.0, 0.0, -1.0].
>>> rst = GDALRaster({"width": 10, "height": 20, "srid": 4326})\n>>> rst.geotransform\n[0.0, 1.0, 0.0, 0.0, 0.0, -1.0]\nComhordanáidí bunús barr ar chlé an raster i gcóras tagartha spásúil na foinse, mar réad pointe le baill x agus y.
>>> rst = GDALRaster({"width": 10, "height": 20, "srid": 4326})\n>>> rst.origin\n[0.0, 0.0]\n>>> rst.origin.x = 1\n>>> rst.origin\n[1.0, 0.0]\nLeithead agus airde picteilín a úsáidtear chun an raster a gheoreferenciú, mar réad pointe le baill x agus y. Féach: attr: geotransform le haghaidh tuilleadh faisnéise.
>>> rst = GDALRaster({"width": 10, "height": 20, "srid": 4326})\n>>> rst.scale\n[1.0, -1.0]\n>>> rst.scale.x = 2\n>>> rst.scale\n[2.0, -1.0]\nComhéifeachtaí sceitheacha a úsáidtear chun an raster a ghearradh, mar réad pointe le baill x agus y. I gcás íomhánna ó thuaidh suas, is iad na comhéifeachtaí seo 0.
>>> rst = GDALRaster({"width": 10, "height": 20, "srid": 4326})\n>>> rst.skew\n[0.0, 0.0]\n>>> rst.skew.x = 3\n>>> rst.skew\n[3.0, 0.0]\nMéid (luachanna teorann) na foinse raster, mar 4-tupól (xmin, ymin, xmax, ymax) i gcóras tagartha spásúil na foinse.
>>> rst = GDALRaster({"width": 10, "height": 20, "srid": 4326})\n>>> rst.extent\n(0.0, -20.0, 10.0, 0.0)\n>>> rst.origin.x = 100\n>>> rst.extent\n(100.0, -20.0, 110.0, 0.0)\nLiosta de na bandaí go léir den fhoinse, mar shama:class: GdalBand cásanna.
\n>>> rst = GDALRaster(\n... {\n... "width": 1,\n... "height": 2,\n... "srid": 4326,\n... "bands": [{"data": [0, 1]}, {"data": [2, 3]}],\n... }\n... )\n>>> len(rst.bands)\n2\n>>> rst.bands[1].data()\narray([[ 2., 3.]], dtype=float32)\nTugann sé leagan chearrtha den raster seo ar ais.
\nIs féidir na paraiméadair warping a shonrú tríd an argóint ds_input`. Tá úsáid ds_input cosúil leis an argóint chomhfhreagrach de thógálaí an aicme. Is foclóir é le tréithe an sprioc-raster. Is iad príomhluachanna foclóra ceadaithe ná leithead, airde, SRID, bunús, scála, scála, cineál sonraí, tiománaí, agus ainm (ainm comhaid).
De réir réamhshocraithe, coinníonn na feidhmeanna warp an chuid is mó de na paraiméadair cothrom le luachanna an raster foinse bunaidh, mar sin ní gá ach paraiméadair ba chóir a athrú a shonrú. Tabhair faoi deara go n-áirítear leis seo an tiománaí, mar sin do rasters comhadbhunaithe cruthóidh an fheidhm warp raster nua ar dhiosca.
\nIs é an t-aon pharaiméadar atá socraithe ar bhealach difriúil ón raster foinse ná an t-ainm. Is é luach réamhshocraithe an ainm raster ainm an raster foinse atá curtha leis '_copy'+source_driver_name. Maidir le rasters comhadbhunaithe moltar cosán comhaid an sprioc-raster a sholáthar.
Is féidir an algartam athshamplála a úsáidtear le haghaidh warping a shonrú leis an argóint athshampling. Is é an réamhshocraithe Comharsanacht is gaire, agus is iad na luachanna ceadaithe eile Bilinear, Cubic`, Cubicspline`, Lanczos`, Meán`, agus Mod.
Is féidir an argóint max_error` a úsáid chun an earráid uasta a thomhaistear i bpicteilíní ionchuir a cheadaítear chun an claochlú a chomhshonrú a shonrú. Is é an réamhshocrú 0.0 le haghaidh ríomhanna cruinne.
\nMaidir le húsáideoirí atá eolach ar GDAL, tá feidhmiúlacht chosúil ag an bhfeidhm seo leis an bhfóntais líne ordaithe gdalwarp.
Mar shampla, is féidir an fheidhm warp a úsáid chun raster a chomhiomlánú go dúbailte a scála picteilín bunaidh:
\n>>> rst = GDALRaster(\n... {\n... "width": 6,\n... "height": 6,\n... "srid": 3086,\n... "origin": [500000, 400000],\n... "scale": [100, -100],\n... "bands": [{"data": range(36), "nodata_value": 99}],\n... }\n... )\n>>> target = rst.warp({"scale": [200, -200], "width": 3, "height": 3})\n>>> target.bands[0].data()\narray([[ 7., 9., 11.],\n [ 19., 21., 23.],\n [ 31., 33., 35.]], dtype=float32)\nDéanann an raster seo a athrú go córas tagartha spásúil difriúil (srs`), a d'fhéadfadh a bheith ina réad a:class: SpatialReference, nó aon ionchur eile a nglactar leis ar:class: SpatialReference (lena n-áirítear tagairt spásúil WKT agus PROJ, nó SRID sláimhir).
\nRíomhann sé teorainneacha agus scála an raster reatha sa chóras tagartha spásúil nua agus cuireann sé an raster ag baint úsáide as an bhfeidhm: attr: ~gdalraster.warp.
\nDe réir réamhshocraithe, úsáidtear tiománaí an raster foinse agus is é ainm an raster an t-ainm bunaidh atá curtha leis '_copy'+source_driver_name. Is féidir tiománaí nó ainm difriúil a shonrú leis na hargóintí tiomána agus ``ainm ``.
Is é an algartam athshamplú réamhshocraithe NearestNeighbour' ach is féidir é a athrú ag baint úsáide as an argóint ``athshampling. Is é 0.0 an earráid réamhshocraithe a cheadaítear le haghaidh athshamplú agus is féidir é a athrú ag baint úsáide as an argóint max_error. Téigh i gcomhairle le cáipéisíocht: attr: ~gdalraster.warp le haghaidh mionsonraí faoi na hargóintí sin.
>>> rst = GDALRaster(\n... {\n... "width": 6,\n... "height": 6,\n... "srid": 3086,\n... "origin": [500000, 400000],\n... "scale": [100, -100],\n... "bands": [{"data": range(36), "nodata_value": 99}],\n... }\n... )\n>>> target_srs = SpatialReference(4326)\n>>> target = rst.transform(target_srs)\n>>> target.origin\n[-82.98492744885776, 27.601924753080144]\nTugann teaghrán ar ais le achoimre ar an raster. Tá sé seo comhionann leis an bhfóntais líne ordaithe `gdalinfo`__.
\nMeiteashonraí an raster seo, a léirítear mar fhoclóir neadaithe. Is é an eochair chéad leibhéil an fearainn meiteashonraí. Tá ainmneacha agus luachanna na míreanna meiteashonraí ó gach fearann sa dara leibhéal.
\nChun mír meiteashonraí a shocrú nó a nuashonrú, cuir an mír meiteashonraí comhfhreagrach ar an modh ag baint úsáide as an struchtúr neadaithe Ní dhéantar ach eochracha atá sa bhfoclóir sonraithe a nuashonrú; fanann an chuid eile de na meiteashonraí gan athrú.
\nChun mír meiteashonraí a bhaint, bain úsáid as None mar an luach meiteashonraí.
>>> rst = GDALRaster({"width": 10, "height": 20, "srid": 4326})\n>>> rst.metadata\n{}\n>>> rst.metadata = {"DEFAULT": {"OWNER": "Django", "VERSION": "1.0"}}\n>>> rst.metadata\n{'DEFAULT': {'OWNER': 'Django', 'VERSION': '1.0'}}\n>>> rst.metadata = {"DEFAULT": {"OWNER": None, "VERSION": "2.0"}}\n>>> rst.metadata\n{'DEFAULT': {'VERSION': '2.0'}}\nLéiriú bytes den raster seo. Tugann sé “None” ar ais do rastróirí nach stóráiltear i gcóras comhaid fíorúil GDAL.
Boolean a léiríonn an bhfuil an raster seo stóráilte i gcóras comhaid fíorúil GDAL.
\nGdalbandLink to this heading#Ní chruthaítear cásanna GdalBand go sainráite, ach a fhaightear ó a: class: GdalRaster réad, trínaí:attr: ~gdalraster.bands tréith. Tá luachanna picteilín iarbhír an raster sna GDALBands.
Ainm nó cur síos ar an mbanna, más ann.
\nLeithead an bhanda i bpicteilíní (X-ais).
\nAirde an bhanda i bpicteilíní (ais Y).
\nAn líon iomlán na bpicteilíní sa bhanda seo. Tá sé comhionann le ``leithead* airde ``.
\nRíomh staitisticí ar luachanna picteilín an bhanda seo. Is é an luach tuairisceáin ná tiúpla leis an struchtúr seo a leanas: (íosta, uasmhéid, meán, diall caighdeánach).
Má shocraítear an argóint thart ``True, féadfar na staitisticí a ríomh bunaithe ar léargas nó ar fho-thacar tíleanna íomhá.
Má shocraítear an argóint refresh ``go `True, ríomhfar na staitisticí ó na sonraí go díreach, agus déanfar an taisce a nuashonrú leis an toradh.
Má aimsítear luach taisce leanúnach, cuirtear an luach sin ar ais. Maidir le formáidí raster a úsáideann seirbhísí Meiteashonraí Cúnta Marthanacha (PAM), d'fhéadfadh na staitisticí a stóráil i gcomhad cúnta. I gcásanna áirithe d'fhéadfadh an meiteashonraí seo a bheith as comhshoncronú leis na luachanna picteilín nó go gcuirfí faoi deara luachanna ó ghlao roimhe seo a thabhairt ar ais nach léiríonn luach na hargóintí ``thart ``. I gcásanna den sórt sin, bain úsáid as an argóint ``refresh ``chun luachanna nuashonraithe a fháil agus iad a stóráil sa taisce.
\nMaidir le bandaí folmha (áit nach “aon sonraí” iad na luachanna picteilín go léir), cuirtear gach staitisticí ar ais mar ``None ``.
\nIs féidir na staitisticí a aisghabháil go díreach freisin trí rochtain a fháil ar airíonna: attr: min, :attr: max, :attr: mean, agus:attr: std.
\nLuach picteilín íosta an bhanda (gan an luach “gan sonraí” a áireamh).
\nLuach picteilín uasta an bhanda (gan an luach “gan sonraí” a áireamh).
\nMeán luachanna picteilín uile an bhanda (gan an luach “gan sonraí” a áireamh).
\nDiall caighdeánach luachanna picteilín uile an bhanda (gan an luach “gan sonraí” a áireamh).
\nDe ghnáth is luach marcóra speisialta é an luach “gan sonraí” do bhanda a úsáidtear chun picteilíní nach sonraí bailí iad a mharcáil. De ghnáth níor chóir picteilíní den sórt sin a thaispeáint, ná cur le hoibríochtaí an
\nChun luach “gan sonraí” atá ann cheana a scriosadh, socraigh an maoin seo go None.
An cineál sonraí atá sa bhanda, mar shlámhshláir tairiseach idir 0 (Anaithnid) agus 14. Más é as_string True, cuirtear an cineál sonraí ar ais mar shreang. <gdal-raster-datatype>Amharc ar an gcolún “GDAL Pixel Type” sa tábla luacha:ref: datetype luach le haghaidh luachanna féideartha.
The color interpretation for the band, as an integer between 0 and 16.\nIf as_string is True, the data type is returned as a string\nwith the following possible values: GCI_Undefined,\nGCI_GrayIndex, GCI_PaletteIndex, GCI_RedBand,\nGCI_GreenBand, GCI_BlueBand, GCI_AlphaBand,\nGCI_HueBand, GCI_SaturationBand, GCI_LightnessBand,\nGCI_CyanBand, GCI_MagentaBand, GCI_YellowBand,\nGCI_BlackBand, GCI_YCbCr_YBand, GCI_YCbCr_CbBand, and\nGCI_YCbCr_CrBand. GCI_YCbCr_CrBand also represents GCI_Max\nbecause both correspond to the integer 16, but only\nGCI_YCbCr_CrBand is returned as a string.
An rochtain ar luachanna picteilín an Gdalband. Filleann sé an sraith sonraí iomlán mura gcuirtear aon pharaiméadair ar fáil. Is féidir fo-thacar den eagar picteilín a iarraidh trí fhritháireamh agus méid bloc a shonrú mar thiúpla.
Má tá NumPy ar fáil, cuirtear na sonraí ar ais mar eagar NumPy. Ar chúiseanna feidhmíochta, moltar go mór NumPy a úsáid.
\nScríobhtar sonraí chuig an Gdalband` má chuirtear an paraiméadar sonraí ``ar fáil. Is féidir leis an ionchur a bheith ar cheann de na cineálacha seo a leanas - sreang pacáilte, maolán, liosta, eagar, agus eagar NumPy. Ba chóir go bhfreagraíonn líon na míreanna san ionchur de ghnáth do líon iomlán na bpicteilín sa bhanda, nó do líon na bpicteilíní le haghaidh bloc sonrach luachanna picteilín má sholáthraítear na paraiméadair ``offset agus ``méide`.
Má tá líon na míreanna san ionchur difriúil ón mbloc picteilín sprioc, caithfear an paraiméadar ``cruth` a shonrú. Is tuple é an cruth a shonraíonn leithead agus airde na sonraí ionchuir i bpicteilíní. Déantar na sonraí a mhacasamhlú ansin chun luachanna picteilín an bhloc roghnaithe a nuashonrú. Tá sé seo úsáideach chun banna iomlán a líonadh le luach amháin, mar shampla.
\nMar shampla:
\n>>> rst = GDALRaster(\n... {"width": 4, "height": 4, "srid": 4326, "datatype": 1, "nr_of_bands": 1}\n... )\n>>> bnd = rst.bands[0]\n>>> bnd.data(range(16))\n>>> bnd.data()\narray([[ 0, 1, 2, 3],\n [ 4, 5, 6, 7],\n [ 8, 9, 10, 11],\n [12, 13, 14, 15]], dtype=int8)\n>>> bnd.data(offset=(1, 1), size=(2, 2))\narray([[ 5, 6],\n [ 9, 10]], dtype=int8)\n>>> bnd.data(data=[-1, -2, -3, -4], offset=(1, 1), size=(2, 2))\n>>> bnd.data()\narray([[ 0, 1, 2, 3],\n [ 4, -1, -2, 7],\n [ 8, -3, -4, 11],\n [12, 13, 14, 15]], dtype=int8)\n>>> bnd.data(data="\\x9d\\xa8\\xb3\\xbe", offset=(1, 1), size=(2, 2))\n>>> bnd.data()\narray([[ 0, 1, 2, 3],\n [ 4, -99, -88, 7],\n [ 8, -77, -66, 11],\n [ 12, 13, 14, 15]], dtype=int8)\n>>> bnd.data([1], shape=(1, 1))\n>>> bnd.data()\narray([[1, 1, 1, 1],\n [1, 1, 1, 1],\n [1, 1, 1, 1],\n [1, 1, 1, 1]], dtype=uint8)\n>>> bnd.data(range(4), shape=(1, 4))\narray([[0, 0, 0, 0],\n [1, 1, 1, 1],\n [2, 2, 2, 2],\n [3, 3, 3, 3]], dtype=uint8)\nMeiteashonraí an bhanda seo. Tá an fheidhmiúlacht comhionann len:attr: gdalraster.metadata.
\nDéanann an chuid seo cur síos ar conas rasters a chruthú ón tús ag baint úsáide as an paraiméadar ds_input.
Cruthaítear raster nua nuair a chuirtear dict chuig an tógálaí:class: GdalRaster. Tá paraiméadair shainmhínithe an raster nua sa fhoclóir, amhail an tionscnamh, méid nó an córas tagartha spásúil. Is féidir sonraí picteilín agus faisnéis faoi fhormáid an raster nua a bheith san fhoclóir freisin. Dá bhrí sin is féidir leis an raster atá mar thoradh air a bheith bunaithe ar chomhad nó cuimhne, ag brath ar an tiománaí a shonraítear.
Níl aon chaighdeán ann chun cur síos a dhéanamh ar shonraí raster i bhfoclóir nó i mblas JSON. Dá bhrí sin tá an sainmhíniú ar ionchur an fhoclóra chuig aicme:class: GdalRaster go sonrach do Django. Tá sé spreagtha ag an bhformáid `geojson`__, ach tá an caighdeán geojson teoranta faoi láthair do fhormáidí veicteora.
\nIs féidir samplaí de úsáid na heochracha éagsúla agus rasters á gcruthú agat a fháil i ndoiciméadú na dtréithe agus na modhanna comhfhreagracha de na haicm:class: GdalRaster agus:class: GdalBand.
\nds_inputLink to this heading#Níl ach cúpla eochair ag teastáil sa fhoclóir ds_input chun raster a chruthú: leithead, aird`, agus srid. Tá luachanna réamhshocraithe ag gach paraiméadar eile (féach an tábla thíos). Tá dlúthbhaint ag liosta na n-eochracha is féidir a rith sa fhoclóir ds_input` ach níl siad comhionann leis na hairíonna: class: GdalRaster. Déantar go leor de na paraiméadair a mhapáil go díreach leis na hairíonna sin; déantar cur síos ar na cinn eile thíos.
Déanann an tábla seo a leanas cur síos ar gach eochracha is féidir a shocrú sa fhoclóir ds_input`.
\nEochair | \nRéamhshocraithe | \nÚsáid | \n
|---|---|---|
| \nriachtanach | \nMapáilte leis an tréith: attr: ~gdalraster.srid | \n
| \nriachtanach | \nMapáilte leis an tréith: attr: ~gdalraster.width | \n
| \nriachtanach | \nMapáilte leis an tréith: attr: ~gdalraster.height | \n
| \n
| \nMapáilte leis an tréith: attr: ~gdalraster.driver | \n
``ainm ` | \n
| \nFéach thíos | \n
| \n
| \nMapáilte leis an tréith: attr: ~gdalraster.origin | \n
``scála `` | \n
| \nMapáilte leis an tréith: attr: ~gdalraster.scale | \n
| \n
| \nMapáilte leis an tréith: attr: ~gdalraster.width | \n
| \n
| \nFéach thíos | \n
| \n
| \nFéach thíos | \n
| \n
| \nFéach thíos | \n
| \n
| \nFéach thíos | \n
Teagán a léiríonn ainm an raster. Agus raster comhbhunaithe á chruthú agat, caithfidh an paraiméadar seo gurb é an cosán comhaid don raster nua. Má thosaíonn an t-ainm le /vsimem/, cruthaítear an raster i gcóras comhaid fíorúil GDAL.
Sláimhir a léiríonn an cineál sonraí do na bandaí go léir. Réamhshocraithe go 6 (Float32). Ceanglaítear go mbeadh an cineál sonraí céanna ag gach banna de raster nua. Is é an mapáil luachanna:
Luach | \nCineál Picteilín GDAL | \nCur síos | \n
|---|---|---|
1 | \nGDT_byte | \n8 giotán sláimhir neamhshínithe | \n
2 | \nGDT_uInt16 | \n16 giotán sláimhir neamhshínithe | \n
3 | \nGDT_Int16 | \nSláimhir sínithe 16 giotán | \n
4 | \nGDT_uInt32 | \nSláimhir 32 giotán gan shíniú | \n
5 | \nGDT_Int32 | \nSláimhir sínithe 32 giotán | \n
6 | \nGDT_Float32 | \nPointe snámh 32 giotán | \n
7 | \nGDT_Float64 | \nPointe snámh 64 giotán | \n
12 | \nGDT_uInt64 | \nSláimhir neamhshínithe 64 giotán (GDAL 3.5+) | \n
13 | \nGDT_Int64 | \nSláimhir shínithe 64 giotán (GDAL 3.5+) | \n
14 | \nGDT_Int8 | \nSláimhir shínithe 8 giotán (GDAL 3.7+) | \n
Sláimhir a léiríonn líon na mbannaí den raster. Is féidir raster a chruthú gan sonraí banna a chur ar aghaidh nuair a chruthaítear iad. Mura sonraítear líon na mbannaí, ríomhtar é go huathoibríoch ó fhad na n-ionchur banda. Ní féidir líon na mbannaí a athrú tar éis a chruthú.
Liosta de fhoclóirí band_input le sonraí ionchuir banna. Tá na hinnéacsanna banna mar thoradh air mar an gcéanna leis an liosta a chuirtear ar fáil. Tá an sainmhíniú ar an bhfoclóir ionchuir banna tugtar thíos. Mura gcuirtear sonraí banna ar fáil, déantar luachanna na mbannaí raster a ionchasadh mar shraith nialas agus socraítear an luach “gan aon sonraí” go ``None ``.
Foclóir le roghanna cruthaithe raster. Cuirtear péirí luach eochair an fhoclóra ionchuir chuig an tiománaí nuair a chruthaítear an raster.
\nTá na roghanna atá ar fáil sainiúil don tiománaí agus déantar cur síos orthu i ndoiciméadú gach tiománaí.
\nNíl na luachanna sa fhoclóir cás-íogair agus déantar iad a thiontú go huathoibríoch go formáid sreinge ceart nuair a chruthaítear iad
\nÚsáideann an sampla seo a leanas cuid de na roghanna atá ar fáil don `tiománaí GTIFF `__. Is é an toradh ná raster comhbhrúite le scéim tíleála inmheánach. Tá méid bloc 23 ag 23 ag na tíleanna inmheánacha:
\n>>> GDALRaster(\n... {\n... "driver": "GTiff",\n... "name": "/path/to/new/file.tif",\n... "srid": 4326,\n... "width": 255,\n... "height": 255,\n... "nr_of_bands": 1,\n... "papsz_options": {\n... "compress": "packbits",\n... "tiled": "yes",\n... "blockxsize": 23,\n... "blockysize": 23,\n... },\n... }\n... )\nband_inputLink to this heading#Is é an eochair bands sa fhoclóir ds_input` liosta de fhoclóirí band_input. Is féidir luachanna picteilín a bheith i ngach foclóir band_input agus an luach “gan sonraí” atá le socrú ar bannaí an raster nua. Féadfaidh méid iomlán an raster nua a bheith ag an eagar sonraí nó a bheith níos lú. Maidir le eagair atá níos lú ná an raster iomlán, rialaíonn na heochracha `méid ``, `cruth, agus offset na luachanna picteilín. Cuirtear na heochracha comhfhreagracha ar aghaidh chuig an modh: meth: ~Gdalband.data. Tá a bhfeidhmiúlacht mar an gcéanna le sonraí na mbanna a shocrú leis an modh sin. Déanann an tábla seo a leanas cur síos ar na heochracha is féidir a úsáid.
Eochair | \nRéamhshocraithe | \nÚsáid | \n
|---|---|---|
| \n
| \nMapáilte leis an tréith: attr: ~gdalband.nodata_value | \n
``sonraí `` | \nMar an gcéanna le | \nRinneadh chuig an modh: meth: ~Gdalband.data | \n
``Méid `` | \n
| \nRinneadh chuig an modh: meth: ~Gdalband.data | \n
| \nMar an gcéanna leis an méid | \nRinneadh chuig an modh: meth: ~Gdalband.data | \n
| \n
| \nRinneadh chuig an modh: meth: ~Gdalband.data | \n
Is féidir le GDAL rochtain a fháil ar chomhaid atá stóráilte sa chóras comhaid, ach tacaíonn sé freisin le córais chomhad fíorúla chun rochtain teibí a fháil ar chineál eile comhaid, mar shampla comhaid chomhbhrúite, criptithe nó iargúlta.
\nTá córas comhaid bunaithe ar chuimhne inmheánach ag GDAL, a cheadaíonn bloic cuimhne a chóireáil mar chomhaid. Is féidir é a úsáid chun rudaí: aicme: GdalRaster a léamh agus a scríobh chuig agus ó mhaoláin comhaid dénártha.
\nTá sé seo úsáideach i gcomhthéacsanna gréasáin ina bhféadfaí rasters a fháil mar mhaolán ó stóráil iargúlta nó a thabhairt ar ais ó radharc gan iad a scríobh ar dhiosca.
\nGDALRaster objects are created in the virtual filesystem when a\nbytes object is provided as input, or when the file path starts with\n/vsimem/.
Caithfidh ionchur a sholáthraítear mar “bytes” a bheith ina léiriú dénártha iomlán ar chomhad. Mar shampla:
\n# Read a raster as a file object from a remote source.\n>>> from urllib.request import urlopen\n>>> dat = urlopen("https://example.com/raster.tif").read()\n# Instantiate a raster from the bytes object.\n>>> rst = GDALRaster(dat)\n# The name starts with /vsimem/, indicating that the raster lives in the\n# virtual filesystem.\n>>> rst.name\n'/vsimem/da300bdb-129d-49a8-b336-e410a9428dad'\nChun raster fíorúil nua atá bunaithe ar chomhad a chruthú ón tús, bain úsáid as ionadaíocht foclóra ds_input` agus tabhair argóint ainm ``a thosaíonn le ``/vsimem/ (le haghaidh mionsonraithe an fhoclóra, féach:ref: gdal-raster-ds-input). Maidir le rastróirí fíorúla comhad-bhunaithe, tugann an tréith: attr: ~gdalraster.vsi_buffer léiriú bytes an raster ar ais.
Seo conas raster a chruthú agus é a thabhairt ar ais mar chomhad in an:class: ~django.http.httpResponse:
\n>>> from django.http import HttpResponse\n>>> rst = GDALRaster(\n... {\n... "name": "/vsimem/temporarymemfile",\n... "driver": "tif",\n... "width": 6,\n... "height": 6,\n... "srid": 3086,\n... "origin": [500000, 400000],\n... "scale": [100, -100],\n... "bands": [{"data": range(36), "nodata_value": 99}],\n... }\n... )\n>>> HttpResponse(rast.vsi_buffer, "image/tiff")\nAg brath ar thógáil áitiúil GDAL d'fhéadfaí tacú le córais chomhad fíorúla eile. Is féidir leat iad a úsáid tríd an gcosán a chuirtear ar fáil réamhfheidhmiú leis an réimír chuí /vsi*/. Féach an doiciméadú `Córais Comhad Fíorúla GDAL `_ le haghaidh tuilleadh sonraí.
Instead of decompressing the file and instantiating the resulting raster, GDAL\ncan directly access compressed files using the /vsizip/, /vsigzip/, or\n/vsitar/ virtual filesystems:
>>> from django.contrib.gis.gdal import GDALRaster\n>>> rst = GDALRaster("/vsizip/path/to/your/file.zip/path/to/raster.tif")\n>>> rst = GDALRaster("/vsigzip/path/to/your/file.gz")\n>>> rst = GDALRaster("/vsitar/path/to/your/file.tar/path/to/raster.tif")\nIs féidir le GDAL tacú le hacmhainní ar líne agus soláthraithe stórála go trédhearcach Chomh fada agus a thógtar é le cumais den sórt sin.
\nChun rochtain a fháil ar chomhad raster poiblí gan aon fhíordheimhniú, is féidir leat /vsicurl/ a úsáid:
>>> from django.contrib.gis.gdal import GDALRaster\n>>> rst = GDALRaster("/vsicurl/https://example.com/raster.tif")\n>>> rst.name\n'/vsicurl/https://example.com/raster.tif'\nMaidir le soláthraithe stórála tráchtála (m.sh. /vsis3/) ba chóir an córas a chumrú roimhe seo le haghaidh fíordheimhnithe agus socruithe eile b'fhéidir (féach doiciméadú `GDAL Virtual Filesystems `_ le haghaidh na roghanna atá ar fáil).
Since GDALRaster always opens new rasters in write mode, it is\nessential to prevent instantiating one from untrusted input. Otherwise, an\nattacker might gain the ability to write a file or make a network request.
To mitigate this, spatial lookups prevent\nstr, pathlib.Path, and dict values from reaching\nGDALRaster altogether. To use these types with lookups, wrap them\nexplicitly with GDALRaster, indicating that the value is trusted.\nBytes are accepted without being wrapped in GDALRaster because they\nare opened through GDAL's memory-based virtual filesystem.
This protection applies only to spatial lookups. Assigning a dict value to\na RasterField will still open a new\nraster, and assigning a str or Path will still fetch and open the\nreferenced raster.
When validating geometry inputs, the\nGeometryField form field will reject raster\nvalues. When validating raster inputs, you should write custom validation.
For defense-in-depth strategies for limiting the available raster drivers, see\nGDAL security considerations.
\n\nBÓTHAIR_LEABHARLANNA_GDALLink to this heading#A string specifying the location of the GDAL library. Typically,\nthis setting is only used if the GDAL library is in a non-standard\nlocation (e.g., /home/john/lib/libgdal.so).
An buneisceacht GDAL, ag léiriú earráid a bhaineann le GDAL.
\nEisceacht a ardaítear nuair a tharlaíonn earráid agus réad córais tagartha spásúil á thógáil nó ag úsáid.
\n