adaptive sampling for CBDM
Project description
raytraverse (1.2.5)
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/latest/.
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 .
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.
Getting Started
the following example script shows the basic workflow for a complete simulation it can be saved to a local file with:
raytraverse examplescript > example.py
or the file is located at raytraverse/example.py
History
1.2.4 (2021-12-03) (not posted until 2022-02-10)
organized command line code
use process pool for sun sampler when raytracing is fast (such as -ab 0 runs with dcomp)
propogate plotp to child sampler if sampling one level
separated utility command line to own entry point. fixed ambiguity in coordinate handedness of some functions (changed kwarg defaults)
1.2.3 (2021-09-03)
fixed rcontrib to work with Radiance/HEAD, radiance version string includes commit
daylightplane - add indirect to -ab 0 sun run (daysim/5-phase style)
lightpointkd - handle adding points with same sample rays
sampler - add repeat function to follow an existing sampling scheme
lightresult - added print function
scene - remove logging from scene class
- cli.py
new command imgmetric, extract rays from image and use same metricfuncs
mew command pull, filter and output 2d data frames from lightresult
add printdata option to suns, to see candidates or border
make TStqdm progress bar class public
- include PositionIndex calculation in BaseMetricSet
new metrics: loggcr and position weighted luminance/gcr
skymapper: filter candidates by positive dirnorm when initialized with epw/wea
- imagetools: parallel process image metrics, also normalize peak with some
assumptions
lightresult: accept slices for findices argument
- sunsamplerpt: at second and thrid sampling levels supplement sampling with
spec_guide at 1/100 the threshold. helps with imterior spaces to find smaller patches of sun
positionindex: fix bug transcribed from evalglare with the positionindex below horizon
1.2.0/2 (2021-05-24)
command line interface development
1.1.2 (2021-02-19)
improved documentation
1.1.0/1 (2021-02-10)
refactor code to operate on a single point at a time
1.0.4 (2020-11-18)
create and manage log file (attribute of Scene) for run directories
possible fix for bug in interpolate_kd resulting in index range errors
protect imports in cli.py so documentation can be built without installing
1.0.3 (2020-11-10)
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.2.5-cp38-cp38-manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 539ad85000ffd7abfc0eec14d5803d4f5545a92c2f1d032199d426df00f7d54a |
|
MD5 | 78c1d9feb32bab99d47ded10a00e4aeb |
|
BLAKE2b-256 | 8606a3b7adbfa4b0255dbc9005d41105429b1b519dc6c7a2ab8a6d1f5bc2d35b |
Hashes for raytraverse-1.2.5-cp38-cp38-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1dd135fb7cb4d6ac21964233d9b3df8ee445444f887483e3a8eb22d9cbd4bf2e |
|
MD5 | 3385c2f1ccbc891878cfecbe68b1d326 |
|
BLAKE2b-256 | fe8bc4aa3d186a9472a91703481a52b176010dae0f3dc06d933e700bd05d0501 |
Hashes for raytraverse-1.2.5-cp37-cp37m-manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 57a41a4deaff49668273332ecc91b071a9c4eea09483017e9a2e92d429096782 |
|
MD5 | f7362de77799b9f06aff9d770d29f078 |
|
BLAKE2b-256 | 42bcb8a972ed2d4b4f49572bcb4607431497f08894ee17a40599f446f4fd07f3 |
Hashes for raytraverse-1.2.5-cp37-cp37m-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 486db5844f077beb815e800f4e4ce4a138ae98b804210c3713ae5a2564b9aeb0 |
|
MD5 | 894cda26badc6d1182bcbf8effe0bfa5 |
|
BLAKE2b-256 | d85a41d537313bdbd13bd2192db35645aae14d65467b38135507f861a02b3f5a |
Hashes for raytraverse-1.2.5-cp36-cp36m-manylinux2010_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 33d63f3f9d2fe37f83b05741a1da96049381426f96c75b9e82d6c19d7c26ce5e |
|
MD5 | 03d1acf2b0640d0b97457e5d1858ed65 |
|
BLAKE2b-256 | 2d70a7e90ec491383ab686bb4edcc950003e7828ad0f78499cc396ce62d8d2f0 |
Hashes for raytraverse-1.2.5-cp36-cp36m-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4ba9c4ddee8e70a3f376c610a515672eddf8f75e6d5dafb3fc1efc9996a9a78c |
|
MD5 | aee679e5ddb8c2d06389cc8d23b120e6 |
|
BLAKE2b-256 | 9f383477b1b42d3263df8109a63888fdc5e52df337215f19ee3432aa1a04df05 |