adaptive sampling for CBDM
Project description
raytraverse (1.0.3)
raytraverse is a complete workflow for climate based daylight modelling, simulation, and evaluation of architectural spaces. Built around a wavelet guided adaptive sampling strategy, raytraverse can fully explore the daylight conditions throughout a space with efficient use of processing power and storage space.
Free software: Mozilla Public License 2.0 (MPL 2.0)
Documentation: https://raytraverse.readthedocs.io/en/stable/.
Installation
The easiest way to install raytraverse is with pip:
pip install --upgrade pip setuptools wheel pip install raytraverse
or if you have cloned this repository:
cd path/to/this/file pip install .
note that on first run the skycalc module may download some auxilary data which could take a minute, after that first run start-up is much faster.
Usage
raytraverse includes a complete command line interface with all commands nested under the raytraverse parent command enter:
raytraverse --help
raytraverse also exposes an object oriented API written primarily in python. calls to Radiance are made through Renderer objects that wrap the radiance c source code in c++ classes, which are made available in python with pybind11. see the src/ directory for more.
For complete documentation of the API and the command line interface either use the Documentation link included above or:
pip install -r docs/requirements.txt make docs
to generate local documentation.
Git Stuff
this project is hosted in two places, a private repo (master branch) at:
and a public repo (release branch) at:
the repo also depends on two submodules, to initialize run the following:
git clone https://github.com/stephanwaz/raytraverse cd raytraverse git submodule init git submodule update --remote git -C src/Radiance config core.sparseCheckout true cp src/sparse-checkout .git/modules/src/Radiance/info/ git submodule update --remote --force src/Radiance
after a “git pull” make sure you also run:
git submodule update
to track with the latest commit used by raytraverse.
Licence
Acknowledgements
Thanks to additional project collaborators and advisors Marilyne Andersen, Lars Grobe, Roland Schregle, Jan Wienold, and Stephen Wittkopf
This software development was financially supported by the Swiss National Science Foundation as part of the ongoing research project “Light fields in climate-based daylight modeling for spatio-temporal glare assessment” (SNSF #179067).
Software Credits
Raytraverse uses Radiance
As well as all packages listed in the requirements.txt file, raytraverse relies heavily on the Python packages numpy, scipy, and pywavelets for key parts of the implementation.
C++ bindings, including exposing core radiance functions as methods to the renderer classes are made with pybind11
Installation and building from source uses cmake and scikit-build
This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.
History
1.0.3
new module for calculating position based on retinal features
view specifications for directview plotting
options for samples/weight visibility on directview plotting
0.2.0 (2020-09-25)
Build now includes all radiance dependencies to setup multi-platform testing
In the absence of craytraverse, sampler falls back to SPRenderer
install process streamlined for developer mode
travis ci deploys linux and mac wheels directly to pypi
- release.sh should be run after updating this file, tests past locally and
docs build.
0.1.0 (2020-05-19)
First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for raytraverse-1.0.3-cp38-cp38-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | df839c84036934523a70c2747b0a8eba78dd645762e188e0616eed8092e01ae1 |
|
MD5 | 5ddec951cbabdd9ca88c542920630442 |
|
BLAKE2b-256 | 8d8178bf7ab7675d5c8feb449f88c5920a372f7240024deda83e5a88cbc267e7 |
Hashes for raytraverse-1.0.3-cp37-cp37m-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ed130315093edfa6dc8e10613f3d93ca75f02bc4f5518a87142059f660644cd0 |
|
MD5 | b8f2fe80acfa2a2d61cafec5a6c4a980 |
|
BLAKE2b-256 | 5f2b181dc1d95f42588cf88c8be3937cf04a6116e5be393b15761d85ec9241bf |
Hashes for raytraverse-1.0.3-cp36-cp36m-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 969dc0ce7a1c0a1301cd28e7d078c771fa5581d1926a78319335b377223ce469 |
|
MD5 | 3fe0b8948c98278853910c54a603cf30 |
|
BLAKE2b-256 | 1add1d79aabce5b3aa45727b23490ada625b09e33f69e7f6900fc4fdf3bed45a |