# phos4dtools

With phos4dtools, a Python-based front end was developed for the Radiance light simulation software and the Raytraverse software based on it for zonal, i.e. temporally and spatially extended simulation. Phos4dtool performs recurring tasks such as converting data, controlling simulation sequences, creating program-specific configurations and providing results in a format suitable for data transfer to the GIS system. It fitted to the need of lighting simulation in ancient built environments providing suitable settings and configuration options in temporal hours and naming conventions of room book as used by archaeologists. The Raytraverse version used for the calculation was 1.4.0, the Radiance version was a development version of 5.3 (see radiance folder).

## Related publications

Grobe, L. O., Noback, A., Wasilewski, S. W., Mächler, C., and Lang, F.  , Zonal reconstruction of daylighting in historic built environments: A workflow to model and evaluate light in spaces and over periods, Proceedings of the 27th International Conference on Cultural Heritage and New Technologies, Propylaeum ebooks, Heidelberg, Germany. 

Grobe, L. O., Mächler, C., Monteoliva Peralta, J. M., and Noback, A. (2023). 'Daylight availability in a Pompeian insula: A quantitative and qualitative assessment', , DOI:https://dx.doi.org/10.5281/zenodo.10155395.

Wasilewski, S., Grobe, L. O., Schregle, R., Wienold, J., and Andersen, M.  2021, Raytraverse: Navigating the Lightfield to Enhance Climate-Based Daylight Modeling, Proceedings of the 12th Annual Symposium on Simulation for Architecture and Urban Design, Society for Computer Simulation International, San Diego, CA, USA. 

Wasilewski, S., Grobe, L. O., Wienold, J., and Andersen, M. (2022). 'Efficient Simulation for Visual Comfort Evaluations', Energy and Buildings, 267, pp. 112141, DOI:https://doi.org/10.1016/j.enbuild.2022.112141.





## src

Taged version of the phos4d-tools under git control (https://igit.architektur.tu-darmstadt.de/phos-4d/phos4dtools) as used in the project. Software is under MIT license and depends on the Raytraverse software (https://pypi.org/project/raytraverse/). Raytraverse itself and therefore the phos4d-tools depend on Radiance lighting simulation software. For installation and basic usage see README.rst in the zip-container (phos4dtools-master.zip). 

## radiance

The Radiance version actually used to calculate the result within this project (for reproducibility). There is no reason to assume that a current stable version of radiance – as of today version 5.4 (https://github.com/LBNL-ETA/Radiance/releases/tag/rad5R4) – would provide significantly different results. For more information on Radiance see: https://www.radiance-online.org/.

## example

The folder contains an example of an insula in Pompeii and documentation to use the phos4dtools including upload and analysis within QGIS. The documentation can also be found here: https://doi.org/10.5281/zenodo.8314590 and the example here: https://c4science.ch/source/CasaNaveEuropa.git.

## analysis_scripst_QGIS

Scripts for the analysis in QGIS as described in the example.

## validation

The phos4dtools were validated utilizing the case-studies Pompeii and Ostia applying a comparison with plain Radiance calculations. The procedure is described in Phos4DValidation.pdf. Raw results and plots can be found in the subfolders Pompeii and Ostia.

For all the Orraon and Ostia case-studies a comparison of the results of different simulation runs with the same setup were undergone. For the case of Ostia for a high and low „ad“ setting (see Phos4DValidation.pdf). The average accordance of individual values in the results were computated as a percentage, giving a general estimate of the stochastic reliability of these values. The folder scatterPlots contains visualization of the results and contains the raw output of the script accordance.sh. See more here:

Noback, Grobe, and Wittkopf 2016
Noback, A., Grobe, L. O., and Wittkopf, S. (2016). 'Accordance of Light Scattering from Design and De-Facto Variants of a Daylight Redirecting Component', Buildings, 3, pp. 30:1-30:17, DOI:doi:10.3390/buildings6030030.

*For more information further consult the documentation in the case-studies.*