SpatialReference

Récapitulatif

Chaque partie de la référence spatiale possède plusieurs propriétés, en particulier le système de coordonnées qui définit les options de projection cartographique utilisées pour déterminer les coordonnées horizontales.

Discussion

Il est facile de créer un objet référence spatiale à partir de jeux de données et de fichiers .prj existants.

  1. Utilisez un fichier .prj comme argument de la classe SpatialReference.
    import arcpy, os
prjFile = os.path.join(arcpy.GetInstallInfo()["InstallDir"],
                       "Coordinate Systems/Geographic Coordinate Systems/North America/NAD 1983.prj")
spatialRef = arcpy.SpatialReference(prjFile)
  2. Utilisez la fonction Describe sur un jeu de données et accédez à sa propriété spatialReference.
    dataset = "C:/Data/Landbase.gdb/Wetlands"
spatialRef = arcpy.Describe(dataset).spatialReference
RemarqueRemarque :

Les propriétés de référence spatiale disponibles dépendent du système de coordonnées utilisé. Dans la liste des propriétés ci-après, les propriétés uniquement disponibles avec un système de coordonnées projetées sont signalées par un 1 : les propriétés uniquement disponibles avec un système de coordonnées géographiques sont signalées par un 2.

Syntaxe

SpatialReference (prjFile)
ParamètreExplicationType de données
prjFile

The projection file used to populate the spatial reference object.

String

Propriétés

PropriétéExplicationType de données
MDomain
(Lecture seule)

The extent of the measure domain.

String
MFalseOriginAndUnits
(Lecture seule)

The measure false origin and units.

String
MResolution
(Lecture et écriture)

The measure resolution.

Double
MTolerance
(Lecture et écriture)

The measure tolerance.

Double
XYResolution
(Lecture et écriture)

The xy resolution.

Double
XYTolerance
(Lecture et écriture)

The xy tolerance.

Double
ZDomain
(Lecture seule)

The extent of the Z domain.

String
ZFalseOriginAndUnits
(Lecture seule)

The Z false origin and units.

String
ZResolution
(Lecture et écriture)

The Z resolution property.

Double
ZTolerance
(Lecture et écriture)

The Z tolerance property.

Double
abbreviation
(Lecture et écriture)

The abbreviated name of the spatial reference.

String
alias
(Lecture et écriture)

The alias of the spatial reference.

String
domain
(Lecture seule)

The extent of the xy domain.

String
factoryCode
(Lecture et écriture)

The factory code of the spatial reference.

Integer
falseOriginAndUnits
(Lecture seule)

The false origin and units.

String
hasMPrecision
(Lecture seule)

Indicates whether or not m-value precision information has been defined.

Boolean
hasXYPrecision
(Lecture seule)

Indicates whether or not xy precision information has been defined.

Boolean
hasZPrecision
(Lecture seule)

Indicates whether or not z-value precision information has been defined.

Boolean
isHighPrecision
(Lecture et écriture)

Indicates whether or not the spatial reference has high precision set.

Boolean
name
(Lecture et écriture)

The name of the spatial reference.

String
remarks
(Lecture et écriture)

The comment string of the spatial reference.

String
type
(Lecture et écriture)

The type of the spatial reference.

String
usage
(Lecture seule)

The usage notes.

String
PCSCode
(Lecture et écriture)

The projected coordinate system code.1

Integer
PCSName
(Lecture et écriture)

The projected coordinate system name.1

String
azimuth
(Lecture et écriture)

The azimuth of a projected coordinate system.1

Double
centralMeridian
(Lecture et écriture)

The central meridian of a projected coordinate system.1

Double
centralMeridianInDegrees
(Lecture et écriture)

The central meridian (Lambda0) of a projected coordinate system in degrees.1

Double
centralParallel
(Lecture et écriture)

The central parallel of a projected coordinate system.1

Double
classification
(Lecture seule)

The classification of a map projection.1

String
falseEasting
(Lecture et écriture)

The false easting of a projected coordinate system.1

Double
falseNorthing
(Lecture et écriture)

The false northing of a projected coordinate system.1

Double
latitudeOf1st
(Lecture et écriture)

The latitude of the first point of a projected coordinate system.1

Double
latitudeOf2nd
(Lecture et écriture)

The latitude of the second point of a projected coordinate system.1

Double
linearUnitCode
(Lecture et écriture)

The linear unit code.1

Integer
linearUnitName
(Lecture et écriture)

The linear unit name.1

String
longitude
(Lecture et écriture)

The longitude value of this prime meridian.1

Double
longitudeOf1st
(Lecture et écriture)

The longitude of the first point of a projected coordinate system.1

Double
longitudeOf2nd
(Lecture et écriture)

The longitude of the second point of a projected coordinate system.1

Double
longitudeOfOrigin
(Lecture et écriture)

The longitude of origin of a projected coordinate system.1

Double
projectionCode
(Lecture et écriture)

The projection code.1

Integer
projectionName
(Lecture et écriture)

The projection name.1

String
scaleFactor
(Lecture et écriture)

The scale factor of a projected coordinate system.1

Double
standardParallel1
(Lecture et écriture)

The first parallel of a projected coordinate system.1

Double
standardParallel2
(Lecture et écriture)

The second parallel of a projected coordinate system.1

Double
GCSCode
(Lecture et écriture)

Code du système de coordonnées géographiques.2

Integer
GCSName
(Lecture et écriture)

Nom du système de coordonnées géographiques.2

String
angularUnitCode
(Lecture et écriture)

Code d'unité angulaire.2

Integer
angularUnitName
(Lecture et écriture)

Nom d'unité angulaire.2

String
datumCode
(Lecture et écriture)

Code du datum.2

Integer
datumName
(Lecture et écriture)

Nom du datum.2

String
flattening
(Lecture et écriture)

Coefficient d'aplatissement de cette sphéroïde.2

Double
longitude
(Lecture et écriture)

Valeur de longitude de ce méridien principal.2

Double
primeMeridianCode
(Lecture et écriture)

Code de méridien principal.2

Integer
primeMeridianName
(Lecture et écriture)

Nom du méridien principal.2

String
radiansPerUnit
(Lecture seule)

Radians par unité angulaire.2

Double
semiMajorAxis
(Lecture et écriture)

Longueur du demi-grand axe de ce sphéroïde.2

Double
semiMinorAxis
(Lecture et écriture)

Longueur du demi-petit axe de ce sphéroïde.2

Double
spheroidCode
(Lecture et écriture)

Code du sphéroïde.2

Integer
spheroidName
(Lecture et écriture)

Nom du sphéroïde.2

String

Vue d'ensemble des méthodes

MéthodeExplication
create ()

Creates the spatial reference object using properties.

createFromFile (prj_file)

Creates the spatial reference object from a projection file.

exportToString ()

Exports the object to its string representation.

loadFromString (string)

Restore the object using its string representation. The exportToString method can be used to create a string representation.

setDomain (x_min, x_max, y_min, y_max)

Sets the XY domain.

setFalseOriginAndUnits (false_x, false_y, xy_units)

Sets the XY false origin and units.

setMDomain (m_min, m_max)

Sets the M domain.

setZDomain (z_min, z_max)

Sets the Z domain.

setMFalseOriginAndUnits (false_m, m_units)

Sets the M false origin and units.

setZFalseOriginAndUnits (false_z, z_units)

Sets the Z false origin and units.

Méthodes

create ()
createFromFile (prj_file)
ParamètreExplicationType de données
prj_file

The projection file used to populate the spatial reference object.

String
exportToString ()
Valeur renvoyée
Type de donnéesExplication
String

The string representation of the object.

loadFromString (string)
ParamètreExplicationType de données
string

The string representation of the object.

String
setDomain (x_min, x_max, y_min, y_max)
ParamètreExplicationType de données
x_min

The minimum x-value.

Double
x_max

The maximum x-value.

Double
y_min

The minimum y-value.

Double
y_max

The maximum y-value.

Double
setFalseOriginAndUnits (false_x, false_y, xy_units)
ParamètreExplicationType de données
false_x

The false x value.

Double
false_y

The false y value.

Double
xy_units

The xy units.

String
setMDomain (m_min, m_max)
ParamètreExplicationType de données
m_min

The minimum m-value.

Double
m_max

The maximum m-value.

Double
setZDomain (z_min, z_max)
ParamètreExplicationType de données
z_min

The minimum z-value.

Double
z_max

The maximum z-value.

Double
setMFalseOriginAndUnits (false_m, m_units)
ParamètreExplicationType de données
false_m

The false m-value.

Double
m_units

The m units.

Double
setZFalseOriginAndUnits (false_z, z_units)
ParamètreExplicationType de données
false_z

The false z-value.

Double
z_units

The false z units.

Double

Exemple de code

Exemple d'objet référence spatiale

Pour chaque classe d'entités d'un espace de travail, imprimez le nom de sa référence spatiale.

import arcpy
from arcpy import env

# Set the workspace environment
#
env.workspace = "C:/base/base.gdb"

# Get a list of the feature classes in the input folder
#
fcs = arcpy.ListFeatureClasses()

# Loop through the list
#
for fc in fcs:
    # Create the spatial reference object
    #
    sr = arcpy.Describe(fc).spatialReference

    # If the spatial reference is unknown
    #
    if sr.name == "Unknown":
        print fc + " has an unknown spatial reference\n"

    # Otherwise, print out the feature class name and
    #   spatial reference
    #
    else:
        print fc + ": " + sr.name + "\n"
Exemple 2 d'objet référence spatiale

Création d'un objet référence spatiale à l'aide d'un fichier .prj

import arcpy

prjFile = "c:/Program Files/ArcGIS/Desktop10.0/Coordinate Systems/Projected Coordinate Systems" + \
           "/Continental/North America/USA Contiguous Equidistant Conic.prj"

# Create a spatial reference object using a projection file
#
sr = arcpy.SpatialReference(prjFile)
Exemple 3 d'objet référence spatiale

Création d'un objet référence spatiale à partir d'un code usine

import arcpy

# Create a spatial reference object using a factory code
#
sr = arcpy.SpatialReference()
sr.factoryCode = 3857
sr.create()

Rubriques connexes

Utilisation de classes dans Python

Copyright © 1995-2012 Esri. Tous droits réservés.
7/10/2012