htrdr: Atmosphere Starter Pack contains input data necessary to perform renderings with htrdr-atmosphere. It also provides GNU Bash scripts that make easier the invocation of the
htrdr-atmosphere program and the description of the scene to render.
ecrad_opt_prop.txt file defines the gas optical properties provided for the pressure and temperature atmospheric vertical profile. These data were generated with the ECRAD software and are saved according to the htgop file format.
The files contained in the
clouds subdirectory contains htcp files defining the liquid water content in suspension within clouds. These fields are generated from idealized Large Eddy Simulations computed by the French non hydrostatic research model, MesoNH (Lafore et al. 1998, Lac et al. 2018), with flat surfaces and prescribed large-scale forcings. Available files are:
DZVAR.1.ARMCU.008.diaKCL.htcp: a continental cumulus case initialized from a composite of observed thermodynamic profiles measured on the ARM SGP site, following Brown et al. (2002). The provided field corresponds to the 8th hour of simulation (13h30 local time), in the middle of the diurnal cycle. The boundary layer is well-developed with cloud base height around 1km and cloud top around 2km, and a total cloud cover of around 25% of the 6.4km x 6.4km domain (horizontal resolution is 25m).
L12km.1.BOMEX.005.htcp: an oceanic, trade wind cumulus case initialized from observed thermodynamic profiles acquired during the BOMEX campaign in the Barbados. The model set-up is as in Siebesma et al. (2003) but with a 12.8km x 12.8km domain and resolution 25m. The cloud layer is between 500m and 1.5km heights and covers around 14% of the domain.
L25.1.FIRE.012.htcp: a marine stratocumulus case initialized from observed thermodynamic profiles acquired during the FIRE campaign off the coast of southern California. The model set-up is as in Duynkerke et al. (2004) with a 25km x 25km domain, 100m horizontal and 10m vertical resolutions. The field corresponds to the 12th hour of simulation (12h local time) typical of a decoupled boundary layer, with the overcast stratocumulus layer between 300 and 600m.
Water droplets properties
Mie_LUT_Cloud-2-10-0.010.nc file stores the spectro-angular tabulation of water droplets optical properties computed using the Mishchenko et al. (2002) implementation of the Lorenz-Mie solution for light scattering by homogeneous spherical particles The monodisperse solution was integrated over a log-normal droplet size distribution of effective radius 10 micrometers and effective variance 0.01 micrometers. This NetCDF file is formatted according to the htmie file format.
models subdirectory contains geometries saved in the htrdr-obj file format. Available geometries are:
models/city.obj: geometry of 19,517,682 triangles of a procedurally generated city using several materials.
models/desert.obj: OBJ of 2,097,152 triangles representing a desert. The geometry starts from 0 and extends to 10 kilometers in both X and Y dimensions. The maximum dune height is 100 meters. The geometry is cylic and thus can be infinitly repeated along the X and Y dimension.
models/mountain.obj: geometry of 8,388,608 triangles representing mountains. The OBJ lower bound is 0 while its upper bound is [10000, 10000, 700] which means that its size along the X and Y axis is 10 kilometers while the highest mountain peaks at 700 meters. Note that the geometry is carefully designed to be cyclic: it can be repeated along the X and Y axis without visual glitches.
models/plane.obj: quad centered in 0 whose size along the X and Y dimension is 10 meters.
models/sea_3m.obj: geometry of 8,388,608 triangles representing a sea starting from 0 and extending to 10 km along the X and Y axis. The maximum wave height is 3 meters. The geometry is cyclic, that means that it can be repeated along the X and Y dimensions.
materials/legacy subdirectory regroups various MruMtl files representing materials whose spectral properties have been collected / inferred from available public sources: handbooks, manufacturer web sites, and public databases such as the USGS High Resolution Spectral Library. Various sources have most of the time been necessary in order to gather data over the whole thermal infrared range.
Finally, a set of htrdr-materials are stored in the
materials directory. Each file is a list materials required by the ground geometries (
sea.mtls), or the whole set of materials contained in the aforementionned sub-directories (
scenes subdirectory stores GNU Bash scripts describing scenes from the aforementioned data (atmosphere, clouds, etc.) and how to render them (image definition, point of view, etc.). These files are actually input files for the
ht-run.sh bash script builds and runs a
htrdr-atmosphere command line from a scene file submitted as input.
Install and run
Download the Atmosphere Starter-Pack archive and verify
its integrity against its PGP
signature. Then extract it. Assuming that
installed and registered in the current shell, one can invoke a
htrdr-atmosphere rendering as bellow:
$ cd ~/htrdr-Atmosphere-Starter-Pack-0.6.1 ~/htrdr-Atmosphere-Starter-Pack-0.6.1 $ bash ht-run.sh scenes/DZVAR2
~/htrdr-Atmosphere-Starter-Pack-0.6.1 the directory
where the Starter Pack is installed. The resulting image
DZVAR2_1280x720x256.txt is stored in the htrdr-image file format. Use the htpp program to convert it in a regular PPM
file that can be then displayed with a regular image viewer.
~/htrdr-Atmosphere-Starter-Pack-0.6.1 $ htpp -o DZVAR2.ppm DZVAR2_1280x720x256.txt
- Update the
ht-run.shscript to handle the command update introduced by
- Add the
sea_3m.objgeometries and their associated
- Update the "ground" geometry of the
L12km_BOMEXscenes: use the desert rather than a plane in
DZVAR2and replace the mountains by a sea in
- Make specular the
- Add new materials generated from the Spectral Library of impervious Ubran Materials (SLUM).
- Define one htrdr-materials file for each ground geometry.
- Update the htrdr-materials files with respect to the fileformat updates introduced by
- Update the
city.objfile. This new geometry fix the interface description, use detailed tree meshes and the new SLUM materials.
- Add the
shortwavescene variables that enable the longwave or shortwave spectral integration onto the defined wavelength range with respect to the Planck function for a given reference temperature. This reference temperature can be set through the
- Update the Mie lookup table: in the previous one, the effective mass was no correctly computed.
- When MPI is enabled, force the path of the output image to the
$HOME/.htrdrlocal directory of the first host listed in the
- remove the
long_waveskeyword: it is now replaced by
- Update the geometry files to make them compatible with
- Add the
city.objgeometry that stores a procedurally generated city.
- Add the
long_wavesvariable to the scene description that enables infrared rendering and defines the range of long waves to take into account.
- Add a list of legacy materials used by the ground geometries.
- Add the
materialsvariable to the scene description that defines the path toward the htrdr-materials file used by the scene.
- Update the layout of the
.htrdrdirectory used when
htrdris ran through MPI. This directory, created at the root directory of each host that shared the computation, saves the input data required by the rendering as well as temporary files. For input files, this directory now strictly follows the layout of the Starter-Pack.
- Handle spaces in paths.
- Update the files describing the scenes as well as the
ht-run.shscript according to the updates introduce by
htrdr0.3: remove the
cache_gridsvariable and replace it by the
cache_skyone that defines whether the sky data structures are cached or not.
Copyright © 2018, 2020, 2021 |Méso|Star> (email@example.com).
Copyright © 2018 CNRS, Université Paul Sabatier.
The MruMtl files contained in the
materials/slum subdirectory are created from the the Spectral Library of impervious Urban Materials, copyright © 2013 University of Reading.
htrdr: Atmosphere Starter Pack is released under the GPLv3+ license: GNU GPL version 3 or later. You can freely study, modify or extend it. You are also welcome to redistribute it under certain conditions; refer to the license for details.