ó J~‰Pc@s¢dZddlmZmZmZddlmZddlmZddl m Z ddl m Z ddlmZdefd „ƒYZd efd „ƒYZd S( sk The Spatial Reference class, represensents OGR Spatial Reference objects. Example: >>> from django.contrib.gis.gdal import SpatialReference >>> srs = SpatialReference('WGS84') >>> print(srs) GEOGCS["WGS 84", DATUM["WGS_1984", SPHEROID["WGS 84",6378137,298.257223563, AUTHORITY["EPSG","7030"]], TOWGS84[0,0,0,0,0,0,0], AUTHORITY["EPSG","6326"]], PRIMEM["Greenwich",0, AUTHORITY["EPSG","8901"]], UNIT["degree",0.01745329251994328, AUTHORITY["EPSG","9122"]], AUTHORITY["EPSG","4326"]] >>> print(srs.proj) +proj=longlat +ellps=WGS84 +datum=WGS84 +no_defs >>> print(srs.ellipsoid) (6378137.0, 6356752.3142451793, 298.25722356300003) >>> print(srs.projected, srs.geographic) False True >>> srs.import_epsg(32140) >>> print(srs.name) NAD83 / Texas South Central iÿÿÿÿ(tbyreftc_char_ptc_int(tGDALBase(t SRSException(tsrs(tsix(t force_bytestSpatialReferencecBsÐeZdZdd„Zd„Zd„Zd„Zdd„Zd„Zd „Z d „Z d „Z d „Z d „Z d„Zed„ƒZed„ƒZed„ƒZed„ƒZed„ƒZed„ƒZed„ƒZed„ƒZed„ƒZed„ƒZed„ƒZed„ƒZed„ƒZed„ƒZd„Zd„Zd„Z d „Z!d!„Z"ed"„ƒZ#edd#„ƒZ$ed$„ƒZ%ed%„ƒZ&edd&„ƒZ'RS('sê A wrapper for the OGRSpatialReference object. According to the GDAL Web site, the SpatialReference object "provide[s] services to represent coordinate systems (projections and datums) and to transform between them." tcCsGd}t|tjƒrmt|tjƒr<|jdƒ}nyt|ƒ}d|}Wq¹tk riq¹XnLt|tjƒrˆd}n1t||jƒr©|}d}nt d|ƒ‚|dkrÎ|}nt dƒ}t j |ƒ}|st d|ƒ‚n ||_|dkr'|j|ƒn|dkrC|j|ƒnd S( s' Creates a GDAL OSR Spatial Reference object from the given input. The input may be string of OGC Well Known Text (WKT), an integer EPSG code, a PROJ.4 string, and/or a projection "well known" shorthand string (one of 'WGS84', 'WGS72', 'NAD27', 'NAD83'). tusertasciisEPSG:%dtepsgtogrsInvalid SRS type "%s"R s+Could not create spatial reference from: %sN(t isinstanceRt string_typest text_typetencodetintt ValueErrort integer_typestptr_typet TypeErrorRtcapitnew_srsRtptrtimport_user_inputt import_epsg(tselft srs_inputtsrs_typetsridRtbuf((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyt__init__1s4          cCs |jrtj|jƒndS(s Destroys this spatial reference.N(t_ptrRt release_srs(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyt__del__bs cCs-t|tƒr|j|ŒS|j|ƒSdS(s‰ Returns the value of the given string attribute node, None if the node doesn't exist. Can also take a tuple as a parameter, (target, child), where child is the index of the attribute in the WKT. For example: >>> 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 symbole. EPSG >>> print(srs['UNIT|AUTHORITY', 1]) # The authority value for the untis 9122 N(Rttuplet attr_value(Rttarget((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyt __getitem__fs cCs|jS(s,The string representation uses 'pretty' WKT.(t pretty_wkt(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyt__str__‚sicCsHt|tjƒ s#t|tƒ r,t‚ntj|jt|ƒ|ƒS(sš The attribute value for the given target node (e.g. 'PROJCS'). The index keyword specifies an index of the child node to return. ( RRRRRRtget_attr_valueRR(RR'tindex((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyR&‡s# cCstj|jt|ƒƒS(s<Returns the authority name for the given string target node.(Rt get_auth_nameRR(RR'((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyt auth_namescCstj|jt|ƒƒS(s<Returns the authority code for the given string target node.(Rt get_auth_codeRR(RR'((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyt auth_code”scCsttj|jƒƒS(s0Returns a clone of this SpatialReference object.(RRt clone_srsR(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pytclone˜scCstj|jƒdS(s8Morphs this SpatialReference from ESRI's format to EPSG.N(Rtmorph_from_esriR(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyt from_esriœscCstj|jƒdS(sš This method inspects the WKT of this SpatialReference, and will add EPSG authority nodes where an EPSG identifier is applicable. N(Rt identify_epsgR(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyR5 scCstj|jƒdS(s.Morphs this SpatialReference to ESRI's format.N(Rt morph_to_esriR(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pytto_esri§scCstj|jƒdS(s6Checks to see if the given spatial reference is valid.N(Rt srs_validateR(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pytvalidate«scCsJ|jr|jdƒS|jr,|jdƒS|jrB|jdƒSdSdS(s+Returns the name of this Spatial Reference.tPROJCStGEOGCStLOCAL_CSN(t projectedR&t geographictlocaltNone(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pytname°s   cCs9yt|jddƒƒSWnttfk r4dSXdS(s>Returns the SRID of top-level authority, or None if undefined.t AUTHORITYiN(RR&RRR@(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyR¸scCs(tj|jttƒƒƒ\}}|S(s%Returns the name of the linear units.(Rt linear_unitsRRR(RtunitsRA((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyt linear_nameÁs$cCs(tj|jttƒƒƒ\}}|S(s&Returns the value of the linear units.(RRCRRR(RRDRA((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyRCÇs$cCs(tj|jttƒƒƒ\}}|S(s&Returns the name of the angular units.(Rt angular_unitsRRR(RRDRA((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyt angular_nameÍs$cCs(tj|jttƒƒƒ\}}|S(s'Returns the value of the angular units.(RRFRRR(RRDRA((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyRFÓs$cCs˜d\}}|js|jrEtj|jttƒƒƒ\}}n0|jrutj |jttƒƒƒ\}}n|dk rŽ|j ƒn||fS(s« Returns a 2-tuple of the units value and the units name, and will automatically determines whether to return the linear or angular units. N(NN( R@R=R?RRCRRRR>RFtdecode(RRDRA((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyRDÙs ' '  cCs|j|j|jfS(s€ Returns a tuple of the ellipsoid parameters: (semimajor axis, semiminor axis, and inverse flattening) (t semi_majort semi_minortinverse_flattening(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyt ellipsoidêscCstj|jttƒƒƒS(s7Returns the Semi Major Axis for this Spatial Reference.(RRIRRR(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyRIòscCstj|jttƒƒƒS(s7Returns the Semi Minor Axis for this Spatial Reference.(RRJRRR(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyRJ÷scCstj|jttƒƒƒS(s:Returns the Inverse Flattening for this Spatial Reference.(Rt invflatteningRRR(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyRKüscCsttj|jƒƒS(se Returns True if this SpatialReference is geographic (root node is GEOGCS). (tboolRt isgeographicR(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyR>scCsttj|jƒƒS(sGReturns True if this SpatialReference is local (root node is LOCAL_CS).(RNRtislocalR(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyR? scCsttj|jƒƒS(sx Returns True if this SpatialReference is a projected coordinate system (root node is PROJCS). (RNRt isprojectedR(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyR=scCstj|j|ƒdS(s>Imports the Spatial Reference from the EPSG code (an integer).N(Rt from_epsgR(RR ((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyRscCstj|j|ƒdS(s3Imports the Spatial Reference from a PROJ.4 string.N(Rt from_projR(Rtproj((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyt import_projscCstj|jt|ƒƒdS(s?Imports the Spatial Reference from the given user input string.N(Rtfrom_user_inputRR(Rt user_input((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyR scCs#tj|jtt|ƒƒƒdS(s3Imports the Spatial Reference from OGC WKT (string)N(Rtfrom_wktRRR(Rtwkt((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyt import_wkt$scCstj|j|ƒdS(s1Imports the Spatial Reference from an XML string.N(Rtfrom_xmlR(Rtxml((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyt import_xml(scCstj|jttƒƒƒS(s9Returns the WKT representation of this Spatial Reference.(Rtto_wktRRR(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyRY-scCstj|jttƒƒ|ƒS(s/Returns the 'pretty' representation of the WKT.(Rt to_pretty_wktRRR(Rtsimplify((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyR)2scCstj|jttƒƒƒS(s=Returns the PROJ.4 representation for this Spatial Reference.(Rtto_projRRR(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyRT7scCs|jS(sAlias for proj().(RT(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pytproj4<scCstj|jttƒƒ|ƒS(s9Returns the XML representation of this Spatial Reference.(Rtto_xmlRRR(Rtdialect((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyR\As((t__name__t __module__t__doc__R!R$R(R*R&R.R0R2R4R5R7R9tpropertyRARRERCRGRFRDRLRIRJRKR>R?R=RRURRZR]RYR)RTRbR\(((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyR)sN 1                tCoordTransformcBs)eZdZd„Zd„Zd„ZRS(s,The coordinate system transformation object.cCsft|tƒ s t|tƒ r/tdƒ‚ntj|j|jƒ|_|j|_|j|_ dS(s<Initializes on a source and target SpatialReference objects.s2source and target must be of type SpatialReferenceN( RRRRtnew_ctR"RRAt _srs1_namet _srs2_name(RtsourceR'((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyR!Is   cCs |jrtj|jƒndS(s.Deletes this Coordinate Transformation object.N(R"Rt destroy_ct(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyR$Qs cCsd|j|jfS(NsTransform from "%s" to "%s"(RkRl(R((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyR*Us(ReRfRgR!R$R*(((s4../Django//lib/python/django/contrib/gis/gdal/srs.pyRiFs  N(RgtctypesRRRtdjango.contrib.gis.gdal.baseRtdjango.contrib.gis.gdal.errorRt"django.contrib.gis.gdal.prototypesRRt django.utilsRtdjango.utils.encodingRRRi(((s4../Django//lib/python/django/contrib/gis/gdal/srs.pytsÿ