Volumen de sombra del sol (3D Analyst)

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

Cuadro de diálogo

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). Desactivado: no se observa el DST. Esta es la opción predeterminada. Activado: se observa el 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. Días—El valor de iteración representará los días. Esta es la opción predeterminada. Horas—El valor de iteración representará una o más horas. Minutos—El valor de iteración representará uno o más minutos.	String

Python

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). ADJUSTED_FOR_DST—Se observa el DST. NOT_ADJUSTED_FOR_DST—No se observa el DST. Esta es la opción predeterminada.	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. DAYS—El valor de iteración representará los días. Esta es la opción predeterminada. HOURS—El valor de iteración representará una o más horas. MINUTES—El valor de iteración representará uno o más minutos.	String

Muestra de código

Ejemplo 1 de SunShadowVolume (ventana de Python)

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)

Ejemplo 2 de SunShadowVolume (script independiente)

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

Entornos

Espacio de trabajo actual, Extensión, Sistema de coordenadas de salida, Transformaciones geográficas, Dominio XY de salida, Dominio Z de salida, Palabra clave CONFIG de salida, Auto ejecución

Información de licenciamiento

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