Sonnenschattenhäufigkeit (3D Analyst)

Zusammenfassung

Berechnet, wie oft bei einer festen Position auf einer Fläche keine direkte Sichtlinie zur Sonne besteht, weil Multipatch-Features diese unterbrechen.

Abbildung

Ergebnis des Werkzeugs "Sonnenschattenhäufigkeit"

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

BeschriftungErläuterungDatentyp
Eingabe-Features

Die Multipatch-Features, die das Hindernis für das Sonnenlicht darstellen.

Feature Layer
Bodenoberfläche

Die 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.

Date
Zeitintervall
(optional)

Das Intervall, das zur Berechnung der Sonnenposition von Startdatum und -uhrzeit bis Enddatum und -uhrzeit verwendet wird.

Time Unit
Zeitzone
(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
Für Sommerzeit angepasst
(optional)

Gibt an, ob die angegebenen Uhrzeiten an die Sommerzeit angepasst werden.

  • Aktiviert: Die eingegebenen Uhrzeiten werden an die Sommerzeit angepasst.
  • Deaktiviert: Die eingegebenen Uhrzeiten werden nicht an die Sommerzeit angepasst. Dies ist die Standardeinstellung.
Boolean
Maximale Schattenlänge
(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

arcpy.ddd.SunShadowFrequency(in_features, ground, out_raster, {cell_size}, {start_time}, {end_time}, {time_interval}, {time_zone}, {dst}, {max_shadow_length})
NameErläuterungDatentyp
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.

  • DSTDie eingegebenen Uhrzeiten werden an die Sommerzeit angepasst.
  • NO_DSTDie eingegebenen Uhrzeiten werden nicht an die Sommerzeit angepasst. Dies ist die Standardeinstellung.
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

SunShadowFrequency example 1 (Python window)

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')

Lizenzinformationen

  • Basic: Erfordert 3D Analyst
  • Standard: Erfordert 3D Analyst
  • Advanced: Erfordert 3D Analyst

Verwandte Themen