Beschriftung | Erläuterung | Datentyp |
Eingabe-Features | Die Multipatch-Features, die das Hindernis für das Sonnenlicht darstellen. | Feature Layer |
Bodenoberfläche | Die Raster-Bodenoberfläche zur Definition der Positionen, an denen das Hindernis für das Sonnenlicht ausgewertet wird. | Raster Layer |
Ausgabe-Schatten-Raster | Das Ausgabe-Raster, dessen Zellenwerte angeben, wie oft die entsprechende Bodenhöhenposition durch die Eingabe-Features verdeckt wurde. | Raster Dataset |
Ausgabe-Zellengröße (optional) | Die Zellengröße des Ausgabe-Rasters. | Linear Unit |
Startzeit (optional) | Datum und Uhrzeit des Beginns der Berechnung der Sonnenposition. Der Standardwert ist das Datum und die Uhrzeit der Initialisierung des Werkzeugs. | Date |
Endzeit (optional) | Datum und Uhrzeit des Endes der Berechnung der Sonnenposition. Der Parameter Zeitintervall wird für die iterative Berechnung jedes Tages von der Startzeit bis zur Endzeit verwendet. Aus diesem Grund darf die Endzeit nicht vor der Startzeit liegen. | Date |
Zeitintervall (optional) | Das Intervall, das zur Berechnung der Sonnenposition von Startdatum und -uhrzeit bis Enddatum und -uhrzeit verwendet wird. | Time Unit |
Zeitzone (optional) | Gibt die Zeitzone an, die den angegebenen Eingabezeiten entspricht, die zur Bestimmung der relativen Position der Sonne verwendet werden sollen.
| String |
Für Sommerzeit angepasst (optional) | Gibt an, ob die eingegebenen Uhrzeiten an die Sommerzeit angepasst werden sollen.
| Boolean |
Maximale Schattenlänge (optional) | Die maximale Entfernung, über die ein Eingabe-Feature bei der Berechnung einen Schatten wirft. Sie sollten diesen Wert definieren, wenn die Position der Sonne einen kleinen Höhenwinkel aufweist, da die resultierenden Schatten lang sind und sich die Verarbeitungszeit möglicherweise unnötig verlängert. | Linear Unit |
Zusammenfassung
Berechnet, wie oft bei einer festen Position auf einer Fläche keine direkte Sichtlinie zur Sonne besteht, weil Multipatch-Features diese unterbrechen.
Abbildung
Verwendung
Die Sonnenposition wird von Startdatum und -uhrzeit bis Enddatum und -uhrzeit berechnet. Bei Angabe eines Zeitintervalls wird die Sonnenposition für jeden Tag zwischen dem Startdatum und Enddatum iterativ von der Startzeit bis zur Endzeit berechnet. Die Zeit, in der sich die Sonne nicht über dem Horizont befindet, wird übersprungen.
Die Zellenwerte des Ausgabe-Rasters stellen die Häufigkeit dar, mit der eine bestimmte Zelle im Schatten liegt. Der maximal mögliche Wert für eine Zelle entspricht der Häufigkeit, mit der sich die Sonne über dem Horizont befindet.
Beim Generieren von Ergebnissen für Sonnenneigungswinkel nahe dem Sonnenauf- und -untergang sollten Sie eine maximale Schattenlänge definieren, um zu vermeiden, dass die Auswirkung langer Schattenflächen berücksichtigt wird. Die Anwendung einer Entfernung trägt außerdem zu einer besseren Performance des Werkzeugs bei.
Parameter
arcpy.ddd.SunShadowFrequency(in_features, ground, out_raster, {cell_size}, {start_time}, {end_time}, {time_interval}, {time_zone}, {dst}, {max_shadow_length})
Name | Erläuterung | Datentyp |
in_features [in_features,...] | Die Multipatch-Features, die das Hindernis für das Sonnenlicht darstellen. | Feature Layer |
ground | Die Raster-Bodenoberfläche zur Definition der Positionen, an denen das Hindernis für das Sonnenlicht ausgewertet wird. | Raster Layer |
out_raster | Das Ausgabe-Raster, dessen Zellenwerte angeben, wie oft die entsprechende Bodenhöhenposition durch die Eingabe-Features verdeckt wurde. | Raster Dataset |
cell_size (optional) | Die Zellengröße des Ausgabe-Rasters. | Linear Unit |
start_time (optional) | Datum und Uhrzeit des Beginns der Berechnung der Sonnenposition. Der Standardwert ist das Datum und die Uhrzeit der Initialisierung des Werkzeugs. | Date |
end_time (optional) | Datum und Uhrzeit des Endes der Berechnung der Sonnenposition. Der Parameter time_interval wird für die iterative Berechnung jedes Tages von der Startzeit bis zur Endzeit verwendet. Aus diesem Grund darf die Endzeit nicht vor der Startzeit liegen. | Date |
time_interval (optional) | Das Intervall, das zur Berechnung der Sonnenposition von Startdatum und -uhrzeit bis Enddatum und -uhrzeit verwendet wird. | Time Unit |
time_zone (optional) | Gibt die Zeitzone an, die den angegebenen Eingabezeiten entspricht, die zur Bestimmung der relativen Position der Sonne verwendet werden sollen.
| String |
dst (optional) | Gibt an, ob die eingegebenen Uhrzeiten an die Sommerzeit angepasst werden sollen.
| Boolean |
max_shadow_length (optional) | Die maximale Entfernung, über die ein Eingabe-Feature bei der Berechnung einen Schatten wirft. Sie sollten diesen Wert definieren, wenn die Position der Sonne einen kleinen Höhenwinkel aufweist, da die resultierenden Schatten lang sind und sich die Verarbeitungszeit möglicherweise unnötig verlängert. | Linear Unit |
Codebeispiel
Anhand des folgenden Beispiels wird die Verwendung dieser Funktion im Python-Fenster veranschaulicht.
import arcpy
arcpy.env.workspace = 'd:\\data'
arcpy.ddd.SunShadowFrequency('Buildings.shp', 'DEM.tif', 'June_Shade.tif',
'4 Feet', '6/1/2018 10:00 AM', '6/30/2018 4:00 PM',
'15 Minutes', 'Pacific Standard Time', 'NO_DST')
Umgebungen
Lizenzinformationen
- Basic: Erfordert 3D Analyst
- Standard: Erfordert 3D Analyst
- Advanced: Erfordert 3D Analyst