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 标准观察者数据
如需使用自己的臭氧和气溶胶表,可在 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。
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 以上对应更浑浊的天空。
HosekWilkieAtmosphere · 随方向变化的天空光照¶
适用于 320–720 nm。模拟近太阳方向或地平线附近的天空时,可用这个模型保留 天空亮度随方向的变化。
NoAtmosphere · 直射太阳光¶
用于理想化场景。太阳直射光无大气衰减,天空散射光为零。
热红外中的天空¶
热红外模拟还需要天空的长波辐射。less.Atmosphere 根据大气廓线计算长波辐射。
SimpleSpectralAtmosphere 等短波光照模型可以使用指定的天空亮度温度:
使用能量平衡时,less.Microclimate 中的向下长波辐射(不给出时由气温和湿度估算)同时用作热红外的天空。详见第 27 章。