Variablen sind Elemente in einem Modell, die einen Wert oder einen Verweis auf Daten enthalten. Variablen können als Eingaben für ein Analysewerkzeug verwendet werden. Die Verwendung von Variablen kann die Iteration von Werkzeugparametern beschleunigen, da Sie die spezifischen Variablenwerte ändern können, ohne das gesamte Dialogfeld des Werkzeugs öffnen zu müssen. Variablen können außerdem verwendet werden, um Eingabewerte für mehrere Analysewerkzeuge freizugeben.
Hinzufügen einer Variablen
Variablen können einem Modellschema aus einem Werkzeugparameter oder als eigenständige Variable hinzugefügt werden.
Hinzufügen einer Variablen aus einem Werkzeugparameter
Eine Variable kann direkt aus einem Werkzeugparameter hinzugefügt werden. Durch das Hinzufügen einer Variable aus einem Werkzeugparameter wird Folgendes sichergestellt:
- Die Variablenstruktur und der Datentyp sind mit dem ausgewählten Werkzeugparameter kompatibel.
- Der standardmäßige oder benutzerdefinierte Wert des Werkzeugparameters wird automatisch gefüllt, sofern anwendbar.
- Die definierten Eingaben des Werkzeugparameters (z. B. ein Menü mit unterstützten Einheiten) sind in der Variable verfügbar, sofern anwendbar.
- Die Variable wird automatisch mit dem Werkzeug verbunden, ohne dass dafür weitere Schritte erforderlich sind.
Führen Sie die folgenden Schritte aus, um eine Variable aus einem Werkzeugparameter hinzuzufügen:
- Führen Sie ggf. die Schritte zum Öffnen eines Modells und Hinzufügen von Daten und Werkzeugen aus.
- Wählen Sie ein Werkzeugelement aus, und klicken Sie auf der Werkzeugleiste des Elements auf Variable hinzufügen
.Das Menü Parameter auswählen... wird angezeigt, in dem die Werkzeugparameter aufgelistet sind.
Wenn Variable hinzufügen nicht verfügbar ist, sind Sie möglicherweise nicht mit einer Analysesitzung verbunden, oder das Modell ist nicht aktiv.
- Klicken Sie auf einen Parameternamen, um ihn auszuwählen.
Die Variable wird zum Modellschema hinzugefügt und mit dem Werkzeug verbunden. Falls der Parameter über einen Standardwert verfügt, wird dieser automatisch zur Variablen hinzugefügt und die Variable wird ausführbereit (blau) angezeigt. Wenn kein standardmäßiger oder benutzerdefinierter Wert vorhanden ist, ist die Variable leer und wird als nicht ausführbar (grau) angezeigt. Sie können das Element öffnen, um den Wert der Variablen zu aktualisieren.
Hinzufügen einer eigenständigen Variablen
Eine eigenständige Variable wird einem Modellschema ohne eine Zuordnung zu Werkzeugparametern hinzugefügt. Nachdem die Variable hinzugefügt wurde, muss sie mit einem Werkzeug verbunden werden, das von einem Werkzeugparameter verwendet werden soll.
Führen Sie die folgenden Schritte aus, um dem Modellschema eine eigenständige Variable hinzuzufügen:
- Führen Sie ggf. die Schritte zum Öffnen eines Modells, zum Herstellen einer Verbindung zu einer Analysesitzung und Aktivieren des Modells aus.
- Klicken Sie auf der Werkzeugleiste "Aktion" auf Variable hinzufügen .
Das Dialogfeld Variable hinzufügen wird mit Optionen für die Variablenstruktur und den Datentyp angezeigt. Die standardmäßige Variablenstruktur ist Einzelner Wert und der Standarddatentyp ist Zeichenfolge.
Wenn Variable hinzufügen nicht verfügbar ist, sind Sie möglicherweise nicht mit einer Analysesitzung verbunden, oder das Modell ist nicht aktiv.
- Wählen Sie für Variablenstruktur auswählen bei Bedarf Mehrere Werte aus.
- Blenden Sie für Variablendatentyp auswählen das Menü ein, und wählen Sie bei Bedarf eine andere Option aus.
- Klicken Sie auf Hinzufügen.
Die Variable wird zum Modellschema hinzugefügt. Sie können das Element öffnen, um den Wert der Variablen zu aktualisieren und eine Verbindung von der Variablen zu einem Werkzeugelement zu zeichnen. Variablen können nur mit kompatiblen Werkzeugparametern verbunden werden.
Verbinden von Variablen mit Werkzeugen
Nachdem eine Variable zum Modellschema hinzugefügt wurde, muss sie mit einem Werkzeug verbunden werden, damit sie für einen Werkzeugparameter verwendet werden kann. Konnektoren können entweder durch direktes Zeichnen im Diagramm oder über das Werkzeugdialogfeld hinzugefügt werden.
Zeichnen einer Verbindung
Führen Sie die folgenden Schritte aus, um eine Verbindung zwischen Variable und Werkzeugelementen zu zeichnen:
- Führen Sie ggf. die Schritte zum Öffnen eines Modells und Hinzufügen von Daten, Werkzeugen und Variablen aus.
- Klicken Sie auf den Port auf der rechten Seite eines Variablenelements, und ziehen Sie ihn auf den Port auf der linken Seite eines Werkzeugelements.
Das Menü Eingabe auswählen... wird angezeigt, in dem die kompatiblen Werkzeugparameter aufgelistet sind.
- Klicken Sie auf den Namen des Parameters, in dem die Variable verwendet werden soll (z. B. Eingabe-Layer).
Zwischen dem Variablenelement und dem Werkzeugelement wird ein Konnektor angezeigt, und es wird eine Überprüfung durch das Werkzeug durchgeführt. Beim Öffnen des Werkzeugdialogfelds wird der Wert der Variablen für den angegebenen Parameter angezeigt.
Verbinden von Variablen über ein Analysewerkzeug
Führen Sie die folgenden Schritte aus, um Variablen über ein Analysewerkzeug zu verbinden:
- Führen Sie ggf. die Schritte zum Öffnen eines Modells und Hinzufügen von Daten, Werkzeugen und Variablen aus.
- Wählen Sie ein Werkzeugelement aus, und klicken Sie auf der Werkzeugleiste des Elements auf Öffnen
, oder doppelklicken Sie auf das Werkzeugelement, um es zu öffnen. - Klicken Sie auf Variable auswählen neben dem Parameter, für den Sie die Variable hinzufügen möchten.
Das Dialogfeld Variable auswählen wird angezeigt und enthält eine Liste der Variablen im Modell, die mit dem Parameter kompatibel sind. Wenn keine Variablen aufgeführt sind, befolgen Sie die Schritte zum Hinzufügen einer Variablen für den Parameter.
- Klicken Sie auf eine Variable, um diese auszuwählen.
Die Variable wird zum Parameter hinzugefügt.
- Aktualisieren Sie alle verbleibenden Parameter, und klicken Sie auf Bestätigen, um die Änderungen zu übernehmen.
Zwischen dem Variablenelement und dem Werkzeugelement wird ein Konnektor angezeigt, und es wird eine Überprüfung durch das Werkzeug durchgeführt.
Aktualisieren einer Variablen
Variablenelemente können geöffnet werden, um den Wert der Variable hinzuzufügen, zu aktualisieren oder zu entfernen.
Führen Sie die folgenden Schritte aus, um eine Eingabedatenvariable zu aktualisieren:
- Führen Sie bei Bedarf die Schritte zum Öffnen des Bereichs ModelBuilder und zum Hinzufügen einer Variablen aus.
- Wählen Sie die Variable aus, und klicken Sie auf der Werkzeugleiste des Elements auf Öffnen , oder doppelklicken Sie auf das Element, um es zu öffnen.
Es wird ein Dialogfeld geöffnet, in dem der Typ der Variablen angezeigt wird.
- Führen Sie einen der folgenden Vorgänge aus:
- Bei Variablen vom Typ "Double" oder "Integer" geben Sie eine Zahl in das Textfeld ein, oder verwenden Sie die Pfeile nach oben und nach unten, um den Wert zu erhöhen oder zu verringern.
- Für Variablen vom Typ "Double" (mehrere Werte) geben Sie eine oder mehrere Zahlen in das Textfeld ein, und klicken Sie zwischen jeder Zahl auf Hinzufügen, oder drücken Sie die Eingabetaste. Um Zahlen zu entfernen, klicken Sie auf die Schaltfläche "Entfernen"
für den Wert. - Für Feature-Layer- oder Tabellen-Variablen klicken Sie auf das Eingabe-Dataset oder die Schaltfläche Layer, und wählen Sie einen Layer aus der Liste aus, oder suchen Sie nach einem unterstützten Layer.
Hinweis:
Wenn die Feature-Layer-Variable bereits mit einem oder mehreren Analysewerkzeugen verbunden ist, stehen nur Datasets zur Verfügung, die mit den Werkzeugen und den Parametern kompatibel sind. Wenn die Parameter nicht die gleichen Features unterstützten (z. B. wenn ein Parameter nur Punkte und der andere nur Polygone unterstützt), kann die Variable die Kompatibilität der Layer nicht ermitteln, was für ein oder mehrere Werkzeuge zu einem Fehler führen kann.
- Geben Sie für Zeichenfolgenvariablen einen Textwert in das Textfeld ein. Wenn die Variable bereits mit einem Analysewerkzeug verbunden ist, kann die Variable ein Menü mit Optionen anzeigen.
- Klicken Sie auf Bestätigen.
Die Variable wird aktualisiert und überprüft.
Variablenstrukturen
Variablen unterstützen die folgenden Strukturen:
- Einzelner Wert: Unterstützt das Hinzufügen eines einzelnen Werts eines einzelnen Datentyps. Variablen mit einzelnem Wert werden für die Datentypen "Feature-Layer", "Tabelle", "Double", "Integer", "Zeichenfolge" und "Lineare Einheit" unterstützt.
- Mehrere Werte: Unterstützt das Hinzufügen mehrerer Werte eines einzelnen Datentyps. Derzeit unterstützen Strukturen mit mehreren Werten nur Datentypen vom Typ Double. Beispielsweise kann eine Variable vom Typ "Double" (mehrere Werte) im Parameter Entfernungswerte für "Puffer erstellen" verwendet werden.
Hinweis:
Parameter, die Variablen vom Typ "Double" mit mehreren Werten unterstützen, unterstützen auch mindestens eine Variable vom Typ "Double" mit einzelnem Wert.
Unterstützte Datentypen
Die folgenden Datentypen werden unterstützt:
- Double: Zahlen mit Dezimalstellen. Dieser Datentyp wird sowohl für Strukturen mit einem einzelnen Wert als auch für Strukturen mit mehreren Werten unterstützt.
- Feature-Layer: Gehostetes Feature-Layer-Element.
- Integer: Zahlen ohne Dezimalstellen. Negative Werte werden in der Variablen unterstützt, jedoch nicht für alle Parameter des Werkzeugs.
- Lineare Einheit: Zahlen und Einheiten.
- Zeichenfolge: Alphanumerische Zeichen und Sonderzeichen.
- Tabelle: Gehostete Tabellenelemente.
Einschränkungen
Werkzeugparameter, die Zeichenfolgenvariablen akzeptieren, verfügen über Listen, in denen die akzeptierten Eingabewerte definiert sind (z. B. ein Menü mit unterstützten Einheiten). Das Hinzufügen von Zeichenfolgenvariablen aus einem Werkzeugparameter bzw. das Verbinden einer Variable mit einem Werkzeugparameter sollte vor dem Aktualisieren des Variablenwertes erfolgen. Das Eingeben eines Wertes in eine nicht verbundene Zeichenfolgenvariable kann zu Fehlern führen.
Die folgenden Werkzeugparameter unterstützen das Hinzufügen einer Variable aus dem Parameter nicht, dafür aber das Verbinden einer eigenständigen Variable:
| Werkzeug | Parameter | Variablentyp |
|---|---|---|
Features verbinden | Ziel-Layer | Feature-Layer oder -Tabelle |
Layer verbinden | ||
Zusammengesetzten Index berechnen | Eingabe-Features oder -Tabelle | |
Nach Attributen filtern | Eingabe-Dataset | |
Feld berechnen | Eingabe-Dataset | |
Punkte aggregieren | Abschnittsgröße | Lineare Einheit |
Zusammenfassen (innerhalb) | Abschnittsgröße | |
Layer anreichern | Messwert | |
Mosaike generieren | Abschnittsgröße |