Domäne erstellen (Data Management)

Zusammenfassung

Dient zur Erstellung von Attributdomänen im angegebenen Workspace.

Verwendung

  • Die Verwaltung von Domänen umfasst folgende Schritte:

    1. Erstellen Sie die Domäne mit diesem Werkzeug.
    2. Fügen Sie der Domäne Werte hinzu oder legen Sie den Wertebereich fest. Verwenden Sie hierfür das Werkzeug Codierten Wert zu Domäne hinzufügen oder Wert für Bereichsdomäne festlegen.
    3. Ordnen Sie der Domäne eine Feature-Class zu. Verwenden Sie hierfür das Werkzeug Domäne zu Feld zuweisen.
  • Domänen mit codierten Werten unterstützen als Teilungsmethode nur die Verfahren "DEFAULT" und "DUPLICATE" und als Vereinigungsmethode nur das Verfahren "DEFAULT".

  • Bereichsdomänen unterstützen alle Teilungs- und Vereinigungsmethoden. Nach einem Teilungs- oder Vereinigungsvorgang werden die Attributwerte der Ausgangs-Features basierend auf den numerischen Werten der Eingabe-Features und der angegebenen Teilungs- und Vereinigungsmethode berechnet.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Workspace

Die Geodatabase, in der die neue Domäne enthalten sein soll

Workspace
Domänenname

Der Name der zu erstellenden Domäne

String
Domänenbeschreibung
(optional)

Die Beschreibung der zu erstellenden Domäne

String
Feldtyp
(optional)

Gibt den Typ der zu erstellenden Attributdomäne an. Attributdomänen sind Regeln, die die zulässigen Werte eines Feldtyps beschreiben. Geben Sie einen Feldtyp an, der mit dem Datentyp des Feldes übereinstimmt, dem die Attributdomäne zugewiesen wird.

  • TextEs wird ein Feld vom Typ "Text" erstellt, das eine Zeichenfolge enthält.
  • Float (einfache Genauigkeit)Es wird ein Feld vom Typ "Float" erstellt, das Bruchzahlen zwischen -3.4E38 und 1.2E38 enthält.
  • Double (doppelte Genauigkeit)Es wird ein Feld vom Typ "Double" erstellt, das Bruchzahlen zwischen -2.2E308 und 1.8E308 enthält.
  • Short (Short Integer)Es wird ein Feld vom Typ "Short" erstellt, das ganze Zahlen zwischen -32.768 und 32.767 enthält.
  • Long (Long Integer)Es wird ein Feld vom Typ "Long" erstellt, das ganze Zahlen zwischen -2.147.483.648 und 2.147.483.647 enthält.
  • DateEs wird ein Feld vom Typ "Datum" erstellt, das ein Datum und/oder eine Uhrzeit enthält.
String
Domänentyp
(optional)

Gibt den Typ der zu erstellenden Domäne an.

  • Domäne mit codierten WertenEs wird eine codierte Typdomäne erstellt, die einen gültigen Satz von Werten für ein Attribut enthält. Dies ist die Standardeinstellung. Eine Domäne mit codierten Werten kann zum Beispiel gültige Werte für Rohrmaterialien enthalten, wie z. B. CL – Gusseisenrohr, DL – Kugelgraphitrohr oder ACP – Asbestbetonrohr.
  • BereichsdomäneEs wird eine Bereichstypdomäne erstellt, die einen gültigen Wertebereich für ein numerisches Attribut enthält. Beispiel: In einer Verteilungshauptwasserleitung ist ein Druck zwischen 50 und 75 psi zulässig. In der Bereichsdomäne werden diese Minimal- und Maximalwerte vorgegeben.
String
Teilungsmethode
(optional)

Gibt die für die erstellte Domäne zu verwendende Teilungsmethode an. Das Verhalten der Werte eines Attributs bei der Teilung eines Features wird durch die jeweilige Teilungsmethode gesteuert.

  • Standardwert des Attributs verwendenDie Attribute der beiden entstehenden Features verwenden den Standardwert für das Attribut der gegebenen Feature-Class oder des gegebenen Subtypes.
  • Doppelte AttributwerteAls Attribut der beiden entstehenden Features wird eine Kopie des Attributwertes des ursprünglichen Objekts verwendet.
  • Geometrisches Verhältnis verwendenDie Attribute der entstehenden Features ergeben sich aus einem Verhältnis zum Wert des ursprünglichen Features. Das Verhältnis basiert auf dem Verhältnis, in dem die ursprüngliche Geometrie geteilt wird. Wenn die Geometrie gleichmäßig geteilt wird, wird jedem Attribut der neuen Features der halbe Wert des ursprünglichen Objektattributs zugewiesen. Die Geometrieverhältnis-Methode gilt nur für Bereichsdomänen.
String
Vereinigungsmethode
(optional)

Gibt die für die erstellte Domäne zu verwendende Vereinigungsmethode an. Wenn zwei Features in ein einzelnes Feature zusammengeführt werden, steuern die Vereinigungsmethoden den Wert der Attribute im neuen Feature.

  • Standardwert des Attributs verwendenDas Attribut des entstehenden Features verwendet den Standardwert für das Attribut der gegebenen Feature-Class oder des gegebenen Subtypes. Dies ist die einzige Vereinigungsmethode, die für nicht numerische Domänen und Domänen mit codierten Werten gilt.
  • Summe der WerteDas Attribut des entstehenden Features nimmt die Summe der Werte des Attributs des ursprünglichen Features an. Die Summenwert-Methode gilt nur für Bereichsdomänen.
  • Gewichteter Durchschnitt für FlächenDas Attribut des entstehenden Features wird als gewichteter Durchschnitt der Attributwerte der ursprünglichen Features berechnet. Dieser Durchschnitt basiert auf der Geometrie des ursprünglichen Features. Die Methode des gewichteten Mittels gilt nur für Bereichsdomänen.
String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierter Eingabe-Workspace

Der aktualisierte Eingabe-Workspace.

Workspace

arcpy.management.CreateDomain(in_workspace, domain_name, {domain_description}, {field_type}, {domain_type}, {split_policy}, {merge_policy})
NameErläuterungDatentyp
in_workspace

Die Geodatabase, in der die neue Domäne enthalten sein soll

Workspace
domain_name

Der Name der zu erstellenden Domäne

String
domain_description
(optional)

Die Beschreibung der zu erstellenden Domäne

String
field_type
(optional)

Gibt den Typ der zu erstellenden Attributdomäne an. Attributdomänen sind Regeln, die die zulässigen Werte eines Feldtyps beschreiben. Geben Sie einen Feldtyp an, der mit dem Datentyp des Feldes übereinstimmt, dem die Attributdomäne zugewiesen wird.

  • TEXTEs wird ein Feld vom Typ "Text" erstellt, das eine Zeichenfolge enthält.
  • FLOATEs wird ein Feld vom Typ "Float" erstellt, das Bruchzahlen zwischen -3.4E38 und 1.2E38 enthält.
  • DOUBLEEs wird ein Feld vom Typ "Double" erstellt, das Bruchzahlen zwischen -2.2E308 und 1.8E308 enthält.
  • SHORTEs wird ein Feld vom Typ "Short" erstellt, das ganze Zahlen zwischen -32.768 und 32.767 enthält.
  • LONGEs wird ein Feld vom Typ "Long" erstellt, das ganze Zahlen zwischen -2.147.483.648 und 2.147.483.647 enthält.
  • DATEEs wird ein Feld vom Typ "Datum" erstellt, das ein Datum und/oder eine Uhrzeit enthält.
String
domain_type
(optional)

Gibt den Typ der zu erstellenden Domäne an.

  • CODEDEs wird eine codierte Typdomäne erstellt, die einen gültigen Satz von Werten für ein Attribut enthält. Dies ist die Standardeinstellung. Eine Domäne mit codierten Werten kann zum Beispiel gültige Werte für Rohrmaterialien enthalten, wie z. B. CL – Gusseisenrohr, DL – Kugelgraphitrohr oder ACP – Asbestbetonrohr.
  • RANGEEs wird eine Bereichstypdomäne erstellt, die einen gültigen Wertebereich für ein numerisches Attribut enthält. Beispiel: In einer Verteilungshauptwasserleitung ist ein Druck zwischen 50 und 75 psi zulässig. In der Bereichsdomäne werden diese Minimal- und Maximalwerte vorgegeben.
String
split_policy
(optional)

Gibt die für die erstellte Domäne zu verwendende Teilungsmethode an. Das Verhalten der Werte eines Attributs bei der Teilung eines Features wird durch die jeweilige Teilungsmethode gesteuert.

  • DEFAULTDie Attribute der beiden entstehenden Features verwenden den Standardwert für das Attribut der gegebenen Feature-Class oder des gegebenen Subtypes.
  • DUPLICATEAls Attribut der beiden entstehenden Features wird eine Kopie des Attributwertes des ursprünglichen Objekts verwendet.
  • GEOMETRY_RATIODie Attribute der entstehenden Features ergeben sich aus einem Verhältnis zum Wert des ursprünglichen Features. Das Verhältnis basiert auf dem Verhältnis, in dem die ursprüngliche Geometrie geteilt wird. Wenn die Geometrie gleichmäßig geteilt wird, wird jedem Attribut der neuen Features der halbe Wert des ursprünglichen Objektattributs zugewiesen. Die Geometrieverhältnis-Methode gilt nur für Bereichsdomänen.
String
merge_policy
(optional)

Gibt die für die erstellte Domäne zu verwendende Vereinigungsmethode an. Wenn zwei Features in ein einzelnes Feature zusammengeführt werden, steuern die Vereinigungsmethoden den Wert der Attribute im neuen Feature.

  • DEFAULTDas Attribut des entstehenden Features verwendet den Standardwert für das Attribut der gegebenen Feature-Class oder des gegebenen Subtypes. Dies ist die einzige Vereinigungsmethode, die für nicht numerische Domänen und Domänen mit codierten Werten gilt.
  • SUM_VALUESDas Attribut des entstehenden Features nimmt die Summe der Werte des Attributs des ursprünglichen Features an. Die Summenwert-Methode gilt nur für Bereichsdomänen.
  • AREA_WEIGHTEDDas Attribut des entstehenden Features wird als gewichteter Durchschnitt der Attributwerte der ursprünglichen Features berechnet. Dieser Durchschnitt basiert auf der Geometrie des ursprünglichen Features. Die Methode des gewichteten Mittels gilt nur für Bereichsdomänen.
String

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_workspace

Der aktualisierte Eingabe-Workspace.

Workspace

Codebeispiel

CreateDomain – Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion CreateDomain im unmittelbaren Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CreateDomain_management("montgomery.gdb", "Materials", 
                              "Valid pipe materials", "TEXT", "CODED")
CreateDomain – Beispiel 2 (eigenständiges Skript)

Dieses eigenständige Skript verwendet die Funktion CreateDomain als Teil eines Workflows, um eine Attributdomäne zu erstellen, dieser Werte zuzuweisen und die Domäne einem Feld in einer Feature-Class zuzuweisen.

# Name: MakeDomain.py
# Description: Create an attribute domain to constrain pipe material values
 
# Import system modules
import arcpy
 
# Set the workspace (to avoid having to type in the full path to the data 
# every time)
arcpy.env.workspace = "C:/data"
 
# Set local parameters
domName = "Material4"
gdb = "montgomery.gdb"
inFeatures = "Montgomery.gdb/Water/Distribmains"
inField = "Material"

# Process: Create the coded value domain
arcpy.CreateDomain_management("montgomery.gdb", domName, "Valid pipe materials", 
                              "TEXT", "CODED")

# Store all the domain values in a dictionary with the domain code as the "key" 
# and the domain description as the "value" (domDict[code])
domDict = {"CI":"Cast iron", "DI": "Ductile iron", "PVC": "PVC", 
           "ACP": "Asbestos concrete", "COP": "Copper"}
    
# Process: Add valid material types to the domain
# use a for loop to cycle through all the domain codes in the dictionary
for code in domDict:        
    arcpy.AddCodedValueToDomain_management(gdb, domName, code, domDict[code])
    
# Process: Constrain the material value of distribution mains
arcpy.AssignDomainToField_management(inFeatures, inField, domName)

Umgebungen

Sonderfälle

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen