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 Teilungsmethoden nur Standardwert und duplizierte Attributwerte und als Vereinigungsmethode nur Standardwert.

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

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
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. Short (16-Bit-Integer)—Der Feldtyp ist "Short". Felder des Typs "Short" unterstützen ganze Zahlen zwischen -32.768 und 32.767. Long (32-Bit-Integer)—Der Feldtyp ist "Long". Felder des Typs "Long" unterstützen ganze Zahlen zwischen -2.147.483.648 und 2.147.483.647. Big Integer (64-Bit-Integer)—Der Feldtyp ist "Big Integer". Felder des Typs "Big Integer" unterstützen ganze Zahlen zwischen -(2^53) und 2^53. Float (32-Bit-Gleitkomma)—Der Feldtyp ist "Float". Felder des Typs "Float" unterstützen Bruchzahlen zwischen -3,4E38 und 1,2E38. Double (64-Bit-Gleitkomma)—Der Feldtyp ist "Double". Felder des Typs "Double" unterstützen Bruchzahlen zwischen -2,2E308 und 1,8E308. Text—Der Feldtyp ist "Text". Felder des Typs "Text" unterstützen eine Zeichenfolge. Datum—Der Feldtyp ist "Datum". Felder des Typs "Datum" unterstützen Datums- und Uhrzeitwerte. Nur Datum—Der Feldtyp ist "Nur Datum". Felder des Typs "Nur Datum" unterstützen Datumswerte ohne Uhrzeitwerte. Nur Zeit—Der Feldtyp ist "Nur Zeit". Felder des Typs "Nur Zeit" unterstützen Uhrzeitwerte ohne Datumswert.	String
Domänentyp (optional)	Gibt den Typ der zu erstellenden Domäne an. Domäne mit codierten Werten—Es wird eine codierte Domäne erstellt, die gültige Werte 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äne—Es wird eine Bereichsdomä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 verwenden—Die Attribute der beiden entstehenden Features verwenden den Standardwert von dem Attribut der angegebenen Feature-Class oder des angegebenen Subtypes. Attributwerte duplizieren—Als Attribut der beiden entstehenden Features wird eine Kopie des Attributwertes des ursprünglichen Objekts verwendet. Geometrisches Verhältnis verwenden—Die Attribute der entstehenden Features ergeben sich aus einem Verhältnis zum Wert des ursprünglichen Features. Das Verhältnis basiert auf den Proportionen, in die 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 verwenden—Das Attribut des entstehenden Features verwendet den Standardwert von dem Attribut der angegebenen Feature-Class oder des angegebenen Subtypes. Dies ist die einzige Vereinigungsmethode, die für nicht-numerische Felder und Domänen mit codierten Werten gilt. Summe der Werte—Das 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ächen—Das 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 Flächendurchschnitts gilt nur für Bereichsdomänen.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierter Eingabe-Workspace	Der aktualisierte Eingabe-Workspace.	Workspace

Python

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

Name	Erläuterung	Datentyp
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. SHORT—Der Feldtyp ist "Short". Felder des Typs "Short" unterstützen ganze Zahlen zwischen -32.768 und 32.767. LONG—Der Feldtyp ist "Long". Felder des Typs "Long" unterstützen ganze Zahlen zwischen -2.147.483.648 und 2.147.483.647. BIGINTEGER—Der Feldtyp ist "Big Integer". Felder des Typs "Big Integer" unterstützen ganze Zahlen zwischen -(2^53) und 2^53. FLOAT—Der Feldtyp ist "Float". Felder des Typs "Float" unterstützen Bruchzahlen zwischen -3,4E38 und 1,2E38. DOUBLE—Der Feldtyp ist "Double". Felder des Typs "Double" unterstützen Bruchzahlen zwischen -2,2E308 und 1,8E308. TEXT—Der Feldtyp ist "Text". Felder des Typs "Text" unterstützen eine Zeichenfolge. DATE—Der Feldtyp ist "Datum". Felder des Typs "Datum" unterstützen Datums- und Uhrzeitwerte. DATEONLY—Der Feldtyp ist "Nur Datum". Felder des Typs "Nur Datum" unterstützen Datumswerte ohne Uhrzeitwerte. TIMEONLY—Der Feldtyp ist "Nur Zeit". Felder des Typs "Nur Zeit" unterstützen Uhrzeitwerte ohne Datumswert.	String
domain_type (optional)	Gibt den Typ der zu erstellenden Domäne an. CODED—Es wird eine codierte Domäne erstellt, die gültige Werte 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. RANGE—Es wird eine Bereichsdomä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. DEFAULT—Die Attribute der beiden entstehenden Features verwenden den Standardwert von dem Attribut der angegebenen Feature-Class oder des angegebenen Subtypes. DUPLICATE—Als Attribut der beiden entstehenden Features wird eine Kopie des Attributwertes des ursprünglichen Objekts verwendet. GEOMETRY_RATIO—Die Attribute der entstehenden Features ergeben sich aus einem Verhältnis zum Wert des ursprünglichen Features. Das Verhältnis basiert auf den Proportionen, in die 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. DEFAULT—Das Attribut des entstehenden Features verwendet den Standardwert von dem Attribut der angegebenen Feature-Class oder des angegebenen Subtypes. Dies ist die einzige Vereinigungsmethode, die für nicht-numerische Felder und Domänen mit codierten Werten gilt. SUM_VALUES—Das 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_WEIGHTED—Das 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 Flächendurchschnitts gilt nur für Bereichsdomänen.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
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.management.CreateDomain("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.management.CreateDomain("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.management.AddCodedValueToDomain(gdb, domName, code, domDict[code])
    
# Process: Constrain the material value of distribution mains
arcpy.management.AssignDomainToField(inFeatures, inField, domName)

Umgebungen

Auto-Commit, Aktueller Workspace