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 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.
Die Sonnenposition wird von Startdatum und -uhrzeit bis Enddatum und -uhrzeit berechnet. Wenn die Berechnung ab Sonnenaufgang erfolgen soll, geben Sie das Startdatum ohne Uhrzeit an. Geben Sie analog dazu das Enddatum ohne Endzeit an, um die Sonnenposition bis zum Sonnenuntergang zu berechnen. Wenn ein Zeitintervall angegeben wurde, wird die Sonnenposition von der Startzeit bis zur Endzeit berechnet.
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.
Syntax
SunShadowFrequency(in_features, ground, out_raster, {cell_size}, {start_time}, {end_time}, {time_interval}, {time_zone}, {dst}, {max_shadow_length})| Parameter | Erklärung | Datentyp |
in_features [in_features,...] | Die Multipatch-Features, die das Hindernis für das Sonnenlicht darstellen. | Feature Layer |
ground | Die 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. Wenn nur das Datum angegeben wurde, wird die Startzeit als Sonnenaufgang für das angegebene Datum definiert. Der Standardwert ist die Zeit (Datum und Uhrzeit), zu der das Werkzeug in der Anwendung geöffnet oder in Python ausgeführt wird. | Date |
end_time (optional) | Datum und Uhrzeit des Endes der Berechnung der Sonnenposition. Wenn nur das Datum angegeben wurde, wird die Endzeit als Sonnenuntergang für das angegebene Datum definiert. | 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) | Die Zeitzone, die den angegebenen Eingabezeiten für die Bestimmung der relativen Position der Sonne entspricht. Die Liste der verfügbaren Werte wird vom Betriebssystem vorgegeben, es ist standardmäßig die Zeitzone der aktuellen Uhrzeit auf dem Computer angegeben. | String |
dst (optional) | Gibt an, ob die angegebenen Uhrzeiten an die Sommerzeit angepasst werden.
| Boolean |
max_shadow_length (optional) | Die maximale Entfernung, über die ein Eingabe-Feature bei der Berechnung einen Schatten wirft. Sie sollten diesen Wert bei Verarbeitungszeiten definieren, bei denen die Position der Sonne einen kleinen Höhenwinkel aufweist, da die resultierenden Schatten lang sind und möglicherweise zusätzlich unnötige Verarbeitungszeit mit sich bringen. | Linear Unit |
Codebeispiel
Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs 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