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.
Syntax
arcpy.3d.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. 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. | 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