| Etiqueta | Explicación | Tipo de datos |
Entidades de entrada | Las entidades multiparche que se utilizarán para modelar las sombras. | Feature Layer |
Fecha y hora de inicio | La fecha y hora de la trayectoria de la luz solar se calculará para modelar las sombras. | Date |
Clase de entidad de salida | La clase de entidad multiparche que almacenará los volúmenes de sombra resultantes. | Feature Class |
Ajustada para el horario de verano (Opcional) | Especifica si el valor de tiempo se ajusta al horario de verano (DST).
| Boolean |
Zona horaria (Opcional) | La zona horaria en la que se encuentra la entrada participante. La configuración predeterminada es la zona horaria en la cual se establece el sistema operativo.
| String |
Fecha y hora de finalización (Opcional) | La fecha y hora finales para calcular la posición del sol. Si solo se proporciona una fecha, se supone que la hora final es la puesta de sol. | Date |
Intervalo de iteración (Opcional) | El valor que se utiliza para definir la iteración de tiempo desde la fecha de inicio. | Double |
Unidad de iteración (Opcional) | La unidad que define el valor de iteración que se aplica a la Fecha y hora de inicio.
| String |
Resumen
Crea volúmenes cerrados que modelan las sombras proyectadas por cada entidad mediante la luz solar para una fecha y hora determinadas.
Uso
Todas las entidades de entrada deben residir en la misma ubicación, ya que los cálculos de la posición relativa del sol se basan en la posición de la primera entidad de la primera clase de entidad.
Las sombras que modelan las condiciones de salida y puesta del sol se pueden realizar proporcionando solo una fecha en los parámetros Fecha y hora de inicio y Fecha y hora de finalización, respectivamente. Los volúmenes de sombras no se generarán si el sol no es visible en una fecha y hora dadas, o bien si la posición relativa del sol está en un ángulo vertical de 90 grados desde las entidades de entrada.
Las sombras se modelan como multiparches cerrados creados mediante la extrusión de las entidades de entrada en la dirección de la luz solar. Se considera que los rayos de luz son paralelos y viajan en la dirección calculada para la posición relativa del sol. Cada volumen de sombra comienza y termina en un plano vertical que es perpendicular a la proyección horizontal de los rayos del sol.
Los siguientes campos se atribuirán a las entidades de volumen de sombra:
- SOURCE: nombre de la clase de entidad que proyecta el volumen de sombra.
- SOURCE_ID: Id. único de la entidad que proyecta el volumen de sombra.
- DATE_TIME: fecha y hora locales utilizadas para calcular la posición del sol.
- AZIMUTH: ángulo en grados entre el norte verdadero y la proyección perpendicular de la posición relativa del sol hasta el horizonte de la Tierra. Los valores varían de 0 a 360.
- VERT_ANGLE: ángulo en grados entre el horizonte de la Tierra y la posición relativa del sol donde el horizonte define 0 grados y 90 grados está justo encima.
Nota:
Por lo general, cada volumen de sombra parece abrazar o proyectarse estrechamente sobre su entidad original. Si no se pudo generar ninguna sombra de esta manera, se creará a partir del límite de la extensión exterior de la entidad. Cuando se crea al menos una sombra de este modo, se incluye un campo llamado HUGS_FEATR para indicar qué sombras abrazan a sus entidades correspondientes.
Parámetros
arcpy.ddd.SunShadowVolume(in_features, start_date_and_time, out_feature_class, {adjusted_for_dst}, {time_zone}, {end_date_and_time}, {iteration_interval}, {iteration_unit})| Nombre | Explicación | Tipo de datos |
in_features [in_features,...] | Las entidades multiparche que se utilizarán para modelar las sombras. | Feature Layer |
start_date_and_time | La fecha y hora de la trayectoria de la luz solar se calculará para modelar las sombras. | Date |
out_feature_class | La clase de entidad multiparche que almacenará los volúmenes de sombra resultantes. | Feature Class |
adjusted_for_dst (Opcional) | Especifica si el valor de tiempo se ajusta al horario de verano (DST).
| Boolean |
time_zone (Opcional) | La zona horaria en la que se encuentra la entrada participante. La configuración predeterminada es la zona horaria en la cual se establece el sistema operativo.
| String |
end_date_and_time (Opcional) | La fecha y hora finales para calcular la posición del sol. Si solo se proporciona una fecha, se supone que la hora final es la puesta de sol. | Date |
iteration_interval (Opcional) | El valor que se utiliza para definir la iteración de tiempo desde la fecha de inicio. | Double |
iteration_unit (Opcional) | La unidad que define el valor de iteración que se aplica a la Fecha y hora de inicio.
| String |
Muestra de código
En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.
arcpy.env.workspace = 'C:/data'
arcpy.ddd.SunShadowVolume('sample.fgdb/buildings',
start_date_and_time='12/25/2011 10:00 AM',
out_feature_class='shadows_dec25.shp',
adjusted_for_dst='ADJUSTED_FOR_DST',
time_zone='Eastern_Standard_Time',
end_date_and_time='12/25/2011 3:00 PM',
iteration_interval='HOURS', iteration_unit=1)En el siguiente ejemplo se muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python.
'''*********************************************************************
Name: Model Shadows For GeoVRML Models
Description: Creates a model of the shadows cast by GeoVRML models
imported to a multipatch feature class for a range of dates
and times. A range of times from the start time and end
time can also be specified by setting the EnforceTimes
Boolean to True. This sample is designed to be used in a
script tool.
*********************************************************************'''
# Import system modules
import arcpy
from datetime import datetime, time, timedelta
#************************* Script Variables **************************
inFiles = arcpy.GetParameterAsText(0) # list of input features
spatialRef = arcpy.GetParameterAsText(1) # list of GeoVRML files
outFC = arcpy.GetParameterAsText(2) # multipatch from 3D files
inTimeZone = arcpy.GetParameterAsText(3) # time zone
startDate = arcpy.GetParameter(4) # starting date as datetime
endDate = arcpy.GetParameter(5) # ending date as datetime
dayInterval = arcpy.GetParameter(6) # day interval as long (0-365)
minInterval = arcpy.GetParameter(7) # minute interval as long (0-60)
enforceTime = arcpy.GetParameter(8) # minute interval as Boolean
outShadows = arcpy.GetParameterAsText(9) # output shadow models
outIntersection = arcpy.GetParameterAsText(10) # shadow & bldg intersection
# Function to find all possible date/time intervals for shadow modelling
def time_list():
dt_result = [startDate]
if dayInterval:
if endDate: #Defines behavior when end date is supplied
while startDate < endDate:
startDate += timedelta(days=dayInterval)
dt_result.append(startDate)
dt_result.append(endDate)
else: # Behavior when end date is not given
daymonthyear = datetime.date(startDate)
while startDate <= datetime(daymonthyear.year, 12, 31, 23, 59):
startDate += timedelta(days=dayInterval)
dt_result.append(startDate)
return dt_result
importFC = arcpy.CreateUniqueName('geovrml_import', 'in_memory')
# Import GeoVRML files to in-memory feature
arcpy.ddd.Import3DFiles(inFiles, importFC, 'ONE_FILE_ONE_FEATURE',
spatialRef, 'Z_IS_UP', 'wrl')
# Ensure that building models are closed
arcpy.ddd.EncloseMultiPatch(importFC, outFC, 0.05)
# Discard in-memory feature
arcpy.management.Delete(importFC)
dt_result = time_list()
for dt in dt_result:
if dt == dt_result[0]:
shadows = outShadows
else:
shadows = arcpy.CreateUniqueName('shadow', 'in_memory')
arcpy.ddd.SunShadowVolume(outFC, dt, shadows, 'ADJUST_FOR_DST',
inTimeZone, '', minInterval, 'MINUTES')
if dt is not dt_result[0]:
arcpy.management.Append(shadows, outShadows)
arcpy.management.Delete(shadows)
arcpy.ddd.Intersect3D(outFC, outIntersection, outShadows, 'SOLID')