跳转至

17 - 光照与大气

场景的光照由两部分组成:太阳(less.Sun)给出太阳的方向和大气层顶的太阳光谱;大气模型计算到达地面的直射光和天空散射光,有的模型还能计算从地面到传感器的大气影响。

import less

scene = less.Scene()
scene.size = 20
scene.terrain = less.Terrain(property=less.Lambertian(reflectance=0.2))
scene.illumination = less.Illumination(
    source=less.Sun(zenith=30, azimuth=150),
    atmosphere=less.SimpleSpectralAtmosphere(turbidity=2.5),
)

Sun 不指定光谱时使用内置的大气层顶太阳光谱。Sun(wavelengths=..., irradiance=...) 可以给出自己的光谱,单位为 W m⁻² nm⁻¹,表示大气层顶垂直于太阳光方向的辐照度。

选择大气模型

模型 适用 说明
less.Atmosphere 卫星和航空影像、大气层顶反射率 分层大气辐射传输,可计算地面光照和到传感器的大气传输
Atmosphere3D 大气内部观测、长斜程和云影 沿三维光路计算大气散射和吸收
less.SixSAtmosphere 习惯使用 6S 参数 使用 Py6S 和 6S 可执行文件
less.PrescribedAtmosphere 已知直射和散射的透过率 直接给出透过率
less.SimpleSpectralAtmosphere 快速的宽波段模拟 简化的光谱衰减,各向同性天空光
less.HosekWilkieAtmosphere 可见光、需要真实的天空亮度分布 320–720 nm
less.NoAtmosphere 不考虑大气 太阳光不衰减,没有天空光

分层大气 Atmosphere

scene.illumination = less.Illumination(
    source=less.Sun(zenith=30, azimuth=150),
    atmosphere=less.Atmosphere.standard(
        "midlatitude_summer",
        aerosol="continental",
        aot550=0.10,
        streams=8,
        sky_mode="anisotropic",
    ),
)

标准大气廓线:

名称 典型条件
"tropical" 热带
"midlatitude_summer" 中纬度夏季
"midlatitude_winter" 中纬度冬季
"subarctic_summer" 亚北极夏季
"subarctic_winter" 亚北极冬季
"us_standard"、"us76" 1976 年美国标准大气

气溶胶类型有 "continental"、"maritime"、"urban"、"desert"、"biomass_burning" 和 "stratospheric"。aot550 是 550 nm 的气溶胶光学厚度,越大直射光衰减越强。场景海拔由地形确定。平地海拔 450 m 时使用 Terrain(ground_altitude_m=450);绝对海拔 DEM 自动记录最低有效高程。单独求解一维大气柱时,可用 air.solve(..., ground_altitude_m=450) 指定柱底。sky_mode="anisotropic" 保留天空亮度随方向的变化,"isotropic" 则把天空光当作各方向均匀。

场景默认用地形参考海拔作为柱底。绝对海拔 DEM 默认取原始最低点;平地还会加上平面的几何高度。显式指定的柱底优先,包括旧工程中保存的零海拔。

自定义廓线

profile = less.AtmosphericProfile.standard("us76")
print(profile.surface_pressure(0.0))                       # hPa
print(profile.column("h2o", ground_altitude_km=0.5))

custom = less.Atmosphere(profile=profile, aerosol="maritime", aot550=0.05)

自定义 AtmosphericProfile 时,高度单位为 km,气压为 hPa,温度为 K,气体数密度为 cm⁻³。

单独计算大气

若海拔 1.25 km 站点的臭氧柱量为 310 DU,调用 profile.scale_ozone(310, ground_altitude_km=1.25) 可取得满足观测柱量的新状态廓线。 缩放保留臭氧垂直分布形状和其他组分的浓度。当前柱求解器的气体吸收表采用标准臭氧丰度。

给不同海拔的站点求解时,可在每次调用中指定柱底,例如 atmosphere.solve([550], sun_zenith=40, ground_altitude_m=2000)。 此处 2000 表示海拔米数;输出高度 output_altitudes_km 以海拔千米表示。 若站点位于场景地形上,可以传入 terrain.altitude_at(x, y)。

不建场景也可以计算大气的光照和透过率:

import numpy as np

atmosphere = less.Atmosphere.standard("us76", aot550=0.10)
wavelengths = np.arange(400.0, 1001.0, 5.0)
result = atmosphere.solve(wavelengths, sun_zenith=40, output_altitudes_km=[2.0, 8.0, 20.0])

direct = result.direct_normal_irradiance          # 地面法向直射辐照度
diffuse = result.diffuse_horizontal_irradiance    # 地面水平天空散射辐照度
up = result.upward_transmittance(view_zenith=10, observer_altitude_km=8.0)
结果 含义
direct_normal_irradiance 地面上垂直于太阳光的直射辐照度
diffuse_horizontal_irradiance 地面水平面上的天空散射辐照度
direct_transmittance 太阳直射透过率
upward_transmittance(...) 地面到某一高度的方向透过率
path_radiance(...) 观测方向上的大气程辐射
to_observer(...) 把地面辐亮度传到某一高度
directional_sky_radiance(...) 天空各方向的辐亮度

辐照度单位为 W m⁻² nm⁻¹,辐亮度为 W m⁻² sr⁻¹ nm⁻¹。

航空和卫星高度的影像

使用 Atmosphere 时,光学传感器可以给出某一海拔高度或大气层顶的辐亮度:

projection = less.Orthographic(image_size=64, view_zenith=10, view_azimuth=180)

airborne = scene.simulate(less.OpticalImager(
    projection, bands=less.Sentinel2A(), spectral_resolution=20, quality=16,
    observation_altitude_km=8.0))

top_of_atmosphere = scene.simulate(less.OpticalImager(
    projection, bands=less.Sentinel2A(), spectral_resolution=20, quality=16,
    observation_level="toa"))

observation_altitude_km 是海拔高度,与投影在场景中的几何高度无关。大气对其他传感器同样起作用:荧光影像计入发射波段的向上透过率,热红外影像计入大气向下的长波辐射和大气自身的发射,激光雷达计入往返两次的大气衰减。

用 Atmosphere3D 模拟三维大气影像

用 Atmosphere3D 可以计算位于大气上方或内部的传感器收到的辐亮度。地形、大气和局地云体处在同一个三维场景中。 下面从大气层顶观测朗伯地表,可见光波段同时计算瑞利散射和臭氧吸收。

import less
from less.atmosphere.coupled import Atmosphere3D

scene = less.Scene(backend="embree")
scene.terrain = less.Terrain(property=less.Lambertian(reflectance=0.2))
air = Atmosphere3D.standard(
    "us76", absorption_database=["O3"],
    interface_altitudes_m=(0., 1000., 2000., 4000., 8000., 16000., 25000., 40000.,
                           60000., 80000.),
)
scene.illumination = less.Illumination(source=less.Sun(zenith=30.), atmosphere=air)
sensor = less.OpticalImager(
    less.Orthographic(image_size=32), bands=[450., 550., 625.],
    observation_level="toa", quality=32,
)
image = scene.simulate(sensor)
image.save("atmosphere.hdr")

standard("us76") 选择标准温压廓线,absorption_database 选择参与计算的气体。 可以按传感器波段增加气体,或用 include_gas_absorption=False 计算纯分子散射。 按名称选择气体时,LESS 会先查找本地文件,首次查询缺失的表时自动下载。

从大气内部观察山谷

干空气分子散射覆盖 230–3125 nm,其中 1700–3125 nm 假定去偏振比为 0.0273。 启用气体吸收或气溶胶时,相应数据也需要覆盖传感器波段。

透视传感器可以在同一幅影像中观测地表和天空。示例 DEM 的最低海拔为 450 m。传感器的局部高度为 240 m,对应海拔 690 m。省略 observation_level 和 observation_altitude_km 时,透视观测从传感器位置开始。

from less.examples.atmosphere_valley import simulate

image = simulate("embree", "valley-output", resolution=(96, 54), quality=128)

示例在球壳大气中计算分子散射,并关闭气体吸收。valley.hdr 和 valley.dat 组成的 ENVI 数据对 保存 470、550、650 nm 的辐亮度。valley.png 将三个波段分别映射到蓝、绿、红通道,并应用显示曝光。比较辐亮度时请使用 ENVI 数据。DEM 高程约定见地形与地表反射。

在三维大气中按名称选择气溶胶

下面的海洋预设使用 80% 相对湿度,550 nm 处的总气溶胶光学厚度为 0.15。

from less.atmosphere.coupled import Atmosphere3D

air = Atmosphere3D.standard(
    "us76", aerosol="marine", aot550=0.15, include_gas_absorption=False,
)

250–3125 nm 支持四个组分 sea_salt、mineral_dust、black_carbon、water_soluble, 以及五个预设 continental、marine、urban、dust、biomass_burning。 预设使用配方湿度。单独选择海盐或水溶性组分时默认干态。 用 aerosol_relative_humidity_percent=73 可指定湿度,支持 0% 和 50–99%。 气体吸收仍由 absorption_database 单独配置。

手工安装时,将所需的 H5 和预设用的 presets.json 放在数据库根目录的 aerosol/ 中。 默认根目录是 LESS 包内的 data/atmospheric-optics-database,也可用 aerosol_database 指定外部根目录。LESS 依次检查本地文件、缓存和镜像,按字节数及 SHA-256 核验。 LESS_ATMOSPHERE_MIRROR 可指定直接提供这些文件的 HTTPS 地址或绝对目录。 默认镜像是 GitHub 上的版本化数据 Release。已有缓存可用 LESS_ATMOSPHERE_OFFLINE=1 离线复用。

三维液水云

运行山地积云示例,可以比较同一视点下的有云和晴空影像。示例输出 RGB 预览图和三个波段的光谱辐亮度。

python -m less.examples.mountain_cumulus --backend optix --resolution 240 135 --quality 32 --output-dir cloud-preview

要使用自己的云场,请提供单位为 kg/m³ 的三维液水含量数组。数组的三个轴依次是高度、南向和东向。 网格起点和单元尺寸按东、南、上填写,单位为场景中的米。液水含量为零的单元是晴空, 所以一个网格可以容纳多团彼此分离的云。同一网格内的云使用相同的云滴有效半径和水温。

from less.atmosphere.coupled import Atmosphere3D, LocalParticleGrid
from less.atmosphere.liquid_cloud import write_liquid_cloud_optics

bands = [450., 550., 625.]
mass_extinction = write_liquid_cloud_optics(
    "droplet-optics.h5", bands=bands, temperature_k=282.43125,
    effective_radius_um=10.,
)
cloud = LocalParticleGrid(
    lower_m=(500., 500., 1200.), cell_size_m=(50., 50., 50.),
    extinction_550_per_m=liquid_water_kg_m3 * mass_extinction,
    aerosol="droplet-optics.h5",
)
air = Atmosphere3D.standard("us76", local_particles=cloud, include_gas_absorption=False)
scene.illumination = less.Illumination(
    source=less.Sun(zenith=45., azimuth=250.), atmosphere=air,
)

创建光学传感器时使用相同的 bands 和光谱分辨率。LESS 首次使用时下载并缓存所需的液水云文件。 RGB 用到 liquid-water-250-900nm.h5,加入 1600 nm 波段时还需要 liquid-water-900-3125nm.h5。手工下载后,可通过 write_liquid_cloud_optics 的 database 参数指定文件目录。云网格用 550 nm 定标,请选择该波长有数据的水温。 液水云光学数据

先用小图确定观测位置、太阳方位和云场范围,再提高 quality 和图像尺寸。 选定最终设置前,可以逐次比较云的亮面、背光面和地面云影。

模拟晴空晚霞

下例从山谷中朝西观测太阳高度 1° 的晴空。下载 CIE 官方的 CIE_xyz_1931_2deg.csv 并在文件所在目录运行下列命令。 示例首次运行时下载臭氧和大陆型气溶胶数据。 CIE 标准观察者数据

python -m less.examples.atmosphere_sunset CIE_xyz_1931_2deg.csv sunset_output

如需使用自己的臭氧和气溶胶表,可在 CSV 前依次传入这两个文件的路径。 默认以 5 nm 间隔计算 79 个波长,以四个独立种子的平均值生成 288 × 168 像元图像。 用 --resolution 96 56 --quality 128 --seeds 5511 可先检查取景。radiance.npz 保存曝光前的光谱辐亮度;sunset.png 以固定曝光、亮度压缩和 sRGB 编码显示。 生成显示图时,示例先将各波长辐亮度除以对应的入射太阳谱辐照度,对所得传输响应 线性插值,再按 0.01 nm 间隔与太阳谱和配色函数一起积分。 场景采用 300 DU 臭氧、550 nm 气溶胶光学厚度 0.07 和光谱反射率恒为 0.12 的地表。 本例的气体吸收仅含臭氧。定量研究氧气 A 带时还需配置氧气吸收表。

臭氧柱量与吸收数据库

ozone_du 以多布森单位(DU)指定臭氧柱量。LESS 先调整臭氧廓线,再按所选吸收表的坐标查询各层吸收系数。研究臭氧变化对辐亮度的影响时,请选择在目标波段含多个 x_O3 节点的表,并检查节点范围能否覆盖各层摩尔分数。Gecko v2 单色表没有这个坐标,改变柱量仍可生成影像,但表内的吸收系数保持原值。

如果要模拟 300 DU 的臭氧柱量,可在上面的示例中增加 ozone_du=300。 成像产品的 metadata["atmosphere_coupling"]["gas_layer_state"]["mole_fractions"]["x_O3"] 记录了各层的臭氧摩尔分数。

单色模拟可以同时指定多种吸收气体,例如 absorption_database={"O2": "oxygen.h5", "O3": "ozone_catalog"}。 使用本地 SO₂ 表时,设置 absorption_database={"SO2": "so2.h5"}。 例如 mole_fractions={"x_SO2": 2e-8} 表示每层均为 20 ppb;分层廓线则按 interface_altitudes_m 从低到高每个区间提供一个值。摩尔分数以空气总分子数为基准。

有 CH₄、N₂O 或 CO 的逐高度资料时,可在 AtmosphericProfile 上分别设置 ch4_cm3、n2o_cm3、co_cm3。每个数组与 altitude_km 一一对应,单位为分子/cm³。 例如,若 methane_ppmv_dry 是廓线各高度的干基甲烷浓度,使用本地单色截面表的写法为

from dataclasses import replace
from less import AtmosphericProfile
from less.atmosphere.coupled import Atmosphere3D

base = AtmosphericProfile.standard("us76")
profile = replace(base, ch4_cm3=(base.air_cm3 - base.h2o_cm3) * methane_ppmv_dry * 1e-6)
air = Atmosphere3D(profile=profile, absorption_database={"CH4": "methane.h5"})

改变分层时,LESS 对高度节点之间的数密度积分并重新计算层平均丰度。若同时设置 mole_fractions["x_CH4"],模拟使用显式给定的层摩尔分数。

本地已有干基 ppmv 廓线库时,可直接调用 AtmosphericProfile.standard("us76", trace_gas_file="trace-state.h5")。 HDF5 根属性为 altitude_unit="km" 和 abundance_basis="dry-air mole fraction, ppmv"。 altitude_km 是递增并覆盖标准大气的高度数组,模型组(如 us_standard)内的 CH4、N2O、CO 可按需提供,每个数据集与高度数组等长。LESS 保留两套网格的 高度节点,按湿度换算为分子数密度。气体吸收截面文件另由 absorption_database 指定。 每个值可以指向 LESS 分子吸收截面文件或分片目录,各表都要覆盖所用波长和大气层状态。 LESS 在同一层、同一波长上累加各气体的体吸收系数,并在产品元数据中按气体记录数据来源。 模拟单种气体的 correlated-k 吸收时,可给出 LESS 的分组截面文件,例如 Atmosphere3D.standard("us76", spectral_mode="correlated_k", absorption_database="oxygen-bands.h5")。 传感器需指定光谱响应曲线。各分带的权重和组数从文件读取,通常可以省略 quadrature_order。以上示例只计氧气的气体吸收。使用预混气体目录时,应选取与目标 气体组成相符的目录,省略求积阶数时使用 16 阶。

如果氧气和臭氧文件来自同一次波长分组,可在 correlated-k 模式下指定 absorption_database={"O2": "O2.h5", "O3": "O3.h5"}。此时改变 ozone_du 可复用 同一对文件。LESS 检查两表的波长分组摘要、有效分带边界和概率权重;物种各自独立排序 得到的表需要重新按共同波长分组生成。

甲烷和一氧化碳吸收重叠时,可设置 absorption_database={"CH4": "CH4.h5", "CO": "CO.h5"}, 并在廓线中提供两种气体的丰度。两张本地表须按共同波长分组生成。氧化亚氮的键为 "N2O"。

单色模拟水汽连续吸收时,使用两张本地 collision-pair-cross-section/1 表, 设置 absorption_database={"H2O-H2O": "self.h5", "H2O-dry_air": "foreign.h5"}。 LESS 将自连续吸收系数乘以水汽数密度的平方,将外来连续吸收系数乘以水汽与干空气 数密度的乘积。如需叠加水汽局地谱线,可再指定 "H2O" 表。MT_CKD 已包含 25 cm⁻¹ 截断处的线形基底,与之配合的局地谱线表应已扣除这一项。

考虑水汽自展宽时,局地谱线表可采用 humidity-dependent-molecular-cross-section/1, 并设置 absorbing_species="H2O"。截面数组 cross_section_m2_per_molecule 的四个轴 依次为 pressure_pa、temperature_k、water_mole_fraction 和 vacuum_wavelength_nm。 水汽摩尔分数以湿空气为分母。LESS 用各层的摩尔分数插值,再乘以该层的水汽数密度。

单色模拟中,可在气体表映射中加入 "O2-O2": "oxygen-pair.h5" 来计算氧分子碰撞对吸收。 本地表采用 collision-pair-cross-section/1 格式,absorbing_species="O2-O2"。 截面数组 cross_section_m5_per_molecule2 的两个轴依次为 temperature_k 和 vacuum_wavelength_nm。LESS 对截面插值后乘以当地氧气数密度的平方。 要构建 297–500 nm 本地表,从 Mainz O₄ 光谱图集 下载 Finkenzeller–Volkamer(2022)的 223、263 和 293 K 三份真空波长光谱至 measurements, 在源码目录运行 python tools/build_oxygen_pair_absorption.py measurements oxygen-pair.h5。 模拟中各层温度须在 223–293 K 内。 准备离线模拟时,可以把同一份映射 sources 传给 prefetch_absorption(sources, bands=[443.]) 和场景的 absorption_database。 预取阶段检查波长覆盖,模拟时再按实际廓线检查层温。

单色吸收可用名称 O3、O2、H2O、CO2、CO、CH4、N2O、NO2、SO2 和 CIA。 例如 Atmosphere3D(absorption_database=["H2O", "CO2", "CIA"]) 逐层读取压力、温度和摩尔分数。 水汽包括逐线、自连续和外来连续吸收,CIA 包括五种碰撞对。缺少的丰度用 mole_fractions 提供,例如 {"x_SO2": 1e-9},也可给每层一个值。 NO₂ 的表到 690 nm,SO₂ 到约 399.984 nm。各实验谱有各自的温压边界。 臭氧近红外的标准廓线近似用 ozone_profile_nir=True 显式选择。

将文件手工放在数据库根目录下的 gas-absorption/ 中即可本地使用,可通过 gas_database 指定根目录。缺少的整文件按需下载并校验,可在不同波段间复用。 例如 less.atmosphere.prefetch_absorption(["O3", "NO2"], bands=[425]) 可提前备齐两个文件, 之后设 LESS_ATMOSPHERE_OFFLINE=1。旧入口 less:shortwave-v1/O3 自动读取新版 O3.h5;更早的 less:ozone-visible-v1 和 less:ozone-visible-v2 可改为 O3。 数据与署名

测站海拔与柱量

使用站点实测柱量时,water_station_altitude_m 和 ozone_station_altitude_m 分别指定水汽和臭氧的测站海拔。例如,450 m 地形上的水汽观测与 1200 m 站点的臭氧 观测可同时约束一份廓线。显式输入的层跨过测站时,LESS 会在站点海拔分层,再计算 各层平均浓度。柱量约束的上界是输入廓线顶部;若输运域更低,模拟仅使用域内部分。

使用自定义粒子光学表

使用自制热红外粒子表时,把文件路径传给 Atmosphere3D.standard(...) 的 aerosol 参数。 若表的波长范围不含 550 nm,在 HDF5 根属性 reference_extinction_550_per_m 中填写同一粒子群、 同一浓度在 550 nm 的消光系数(m⁻¹,正值)。LESS 据此按场景的 aot550 或局部 550 nm 消光系数缩放各波长的消光。传感器波长须落在表内的波长范围中。

有本地液水云清单时,可以按清单中已有的有效半径(µm)选表。把 HDF5 文件放在清单旁, 或用 LESS_ATMOSPHERE_MIRROR 指定文件所在的 HTTPS 目录或本地绝对目录。 首次下载后,设置 LESS_ATMOSPHERE_OFFLINE=1 即可使用校验过的缓存。

from less.atmosphere import prefetch_liquid_cloud
from less.atmosphere.coupled import Atmosphere3D

cloud = prefetch_liquid_cloud("manifest.json", temperature_k=298.15, effective_radius_um=10)
air = Atmosphere3D.standard(
    "us76", aerosol=str(cloud), aot550=0.4, include_gas_absorption=False,
)

多温度清单须指定已收录的水温,单温度清单可只给有效半径。将热红外窗口表用于 aot550 场景时,需要表中含有对应水温下的 550 nm 参考消光。

SixSAtmosphere · 6S

这个模型用 6S 计算到达地面的短波直射和散射光照。安装 Py6S,并将 sixs 可执行文件 加入 PATH。

pip install "less3d[atmosphere]"
six_s = less.SixSAtmosphere(
    atmosphere_profile="midlatitude_summer",
    aerosol_type="continental",
    aot550=0.1,
    ground_altitude=0.0,
)

可用廓线包括 tropical、midlatitude_summer、midlatitude_winter、 subarctic_summer、subarctic_winter、us_standard(美国标准大气 1962)和 no_absorption。气溶胶类型有 no_aerosols、continental、maritime、 urban、desert、biomass_burning 和 stratospheric。 通过 Illumination(atmosphere=six_s) 使用该模型。

PrescribedAtmosphere · 给定透过率

已经知道大气的直射和散射透过率时:

scene.illumination = less.Illumination(
    source=less.Sun(zenith=40, azimuth=160,
                    wavelengths=[450, 550, 650],
                    irradiance=[1.85, 1.88, 1.55]),
    atmosphere=less.PrescribedAtmosphere(
        wavelengths=[450, 550, 650],
        direct_beam_transmittance=[0.60, 0.70, 0.78],
        diffuse_horizontal_transmittance=[0.20, 0.14, 0.09],
    ),
)

两个系数的定义不同:

  • direct_beam_transmittance = 地面直射辐照度(垂直于光线)/ 大气层顶太阳辐照度(垂直于光线);
  • diffuse_horizontal_transmittance = 地面水平面上的天空散射辐照度 / 大气层顶太阳光在水平面上的辐照度。

即对于太阳天顶角 θ、大气层顶辐照度 E:

地面直射辐照度(垂直于光线) = E × direct_beam_transmittance
地面水平散射辐照度           = E × cos θ × diffuse_horizontal_transmittance

两个系数可以是数值或光谱数组,同一波长上两者之和不超过 1。

SimpleSpectralAtmosphere · 快速短波光照

用于快速估算 300–2500 nm 的直射和散射光照。模型将天空散射光视为各向同性。 turbidity 约为 2 时代表晴朗天空,5 以上对应更浑浊的天空。

air = less.SimpleSpectralAtmosphere(turbidity=2.5)

HosekWilkieAtmosphere · 随方向变化的天空光照

适用于 320–720 nm。模拟近太阳方向或地平线附近的天空时,可用这个模型保留 天空亮度随方向的变化。

air = less.HosekWilkieAtmosphere(turbidity=2.5)

NoAtmosphere · 直射太阳光

用于理想化场景。太阳直射光无大气衰减,天空散射光为零。

air = less.NoAtmosphere()

热红外中的天空

热红外模拟还需要天空的长波辐射。less.Atmosphere 根据大气廓线计算长波辐射。 SimpleSpectralAtmosphere 等短波光照模型可以使用指定的天空亮度温度:

clear_sky = less.SimpleSpectralAtmosphere(turbidity=2.0, sky_temperature=260.0)  # K

使用能量平衡时,less.Microclimate 中的向下长波辐射(不给出时由气温和湿度估算)同时用作热红外的天空。详见第 27 章。

下一步