Describe

Récapitulatif

La fonction Describe renvoie un objet Describe avec plusieurs propriétés, telles qu'un type de données, des champs, des index, etc. Ses propriétés sont dynamiques, ce qui signifie que selon le type de données décrit, différentes propriétés de description peuvent être utilisées.

Les propriétés Describe sont organisées en une série de groupes de propriétés. Tout jeu de données particulier acquiert les propriétés d'au moins un de ces groupes. Par exemple, lors de la description d'une classe d'entités de géodatabase, vous pouvez accéder aux propriétés des groupes de propriétés GDB FeatureClass, FeatureClass, Table et Dataset. Toutes les données, quel que soit leur type, acquièrent toujours les propriétés génériques de l'objet Describe.

Discussion

De nombreux types de données comprennent des propriétés provenant d'autres groupes de propriétés. Par exemple, lors de la description d'une classe d'entités de géodatabase, vous pouvez accéder aux propriétés des groupes de propriétés GDB FeatureClass, FeatureClass, Table et Dataset.

Remarque :

Dans certains cas, l'objet renvoyé par Describe n'a pas toutes les propriétés documentées pour lui. Par exemple, l'objet Describe pour une couche dans la table des matières d'ArcMap n'a pas de jeu de propriétés de couche. Cette propriété existe uniquement si vous décrivez un fichier .lyr.

Si vous tentez d'accéder à une propriété qu'un objet Describe n'a pas, il renvoie une erreur ou une valeur vide (None, 0 ou -1, chaîne vide). Si vous n'êtes pas sûr d'une propriété en particulier, vous pouvez faire appel à la fonction hasattr() de Python pour la vérifier.

Propriétés de l'objet DescribePropriétés de l'élément ArcInfoPropriétés de la table ArcInfoPropriétés du jeu de données de dessin DAOPropriétés des classes d'entités DAOPropriétés des classes d'entités de couverturePropriétés de la couverturePropriétés du jeu de donnéesPropriétés de table dBasePropriétés de la classe d'entitésPropriétés de fichierPropriétés du dossierPropriétés des classes d'entités de géodatabasePropriétés de la table de géodatabasePropriétés du réseau géométriquePropriétés des couchesPropriétés de la cartePropriétés de la mosaïquePropriétés de la couche Network AnalystPropriétés du jeu de données réseauPropriétés des fichiers prjPropriétés du canal rasterPropriétés du catalogue d'imagesPropriétés du jeu de données rasterPropriétés de la classe de relationsPropriétés de la classe de représentationsPropriétés des jeux de données schématiquesPropriétés des diagrammes schématiquesPropriétés des dossiers schématiquesPropriétés des classes d'entités SDCPropriétés des classes d'entités de fichiers de formesPropriétés de la tablePropriétés de la vue tabulairePropriétés du fichier textePropriétés des TINPropriétés de l'outilPropriétés des boîtes à outilsPropriétés de la topologiePropriétés de la couverture VPFPropriétés des classes d'entités VPFPropriétés de la table VPFPropriétés de l'espace de travail

Syntaxe

Describe (value)

Paramètre	Explication	Type de données
value	The specified data element or geoprocessing object to describe.	String

Valeur renvoyée

Type de données	Explication
Describe	Renvoie un objet avec les propriétés qui détaillent l'élément de données décrit. Certaines des propriétés de l'objet renvoyé vont contenir des valeurs littérales ou des objets.

Exemple de code

Exemple de propriétés de la fonction Describe (script autonome)

Le script autonome suivant présente quelques propriétés de couche et de l'objet Describe provenant d'un jeu de couches par un paramètre de script. Il est possible de définir le paramètre comme étant un fichier .lyr ou une couche dans ArcMap.

import arcpy

# Get the layer as a parameter and describe it.
#
# The layer could be a layer in ArcMap (like "some_layer")
# Or, it could be a .lyr file (like "C:/data/some.lyr")
#
layerString = arcpy.GetParameterAsText(0)
desc = arcpy.Describe(layerString)

# Print selected layer and describe object properties
# 
print "Name:", desc.name
if hasattr(desc, "layer"):
    print "Layer name:", desc.layer.name
    print "Layer data source:", desc.layer.catalogPath
    print ".lyr file:", desc.catalogPath
else:
    print "Layer name:", desc.name
    print "Layer data source:", desc.catalogPath

if desc.fidSet != '':
    print "Number of selected features:", str(len(desc.fidSet.split(";")))