README.md (2592B)
1 # Schiff 2 3 The purpose of this program is to estimate the radiative properties of 4 soft particles with an "Approximation Method for Short Wavelength or 5 High-Energy Scattering" (L. Schiff, 1956). 6 It relies on the model detailed in "Monte Carlo Implementation of 7 Schiff's Approximation for Estimating Radiative Properties of 8 Homogeneous, Simple\-Shaped and Optically Soft Particles: Application to 9 Photosynthetic Micro-Organisms" 10 ([Charon et al. 2015](http://www.sciencedirect.com/science/article/pii/S0022407315003283)). 11 12 ## Prerequisites 13 - C compiler 14 - POSIX make 15 - pkg-config 16 - [LibYAML](http://pyyaml.org/wiki/LibYAML), 17 - [RSys](https://www.meso-star.com/git/rsys) 18 - [Star-3D](https://www.meso-star.com/git/star-3d) 19 - [Star-Schiff](https://www.meso-star.com/git/star-schiff) 20 - [Star-SP](https://www.meso-star.com/git/star-sp) 21 22 ## Installation 23 24 Edit config.mk as needed, then run: 25 26 make clean install 27 28 ## Release notes 29 30 ### Version 0.5 31 32 - Replace CMake by Makefile as build system. 33 - Update compiler and linker flags to increase the security and 34 robustness of generated binaries. 35 - Convert the manual from man to mdoc. 36 - Thoroughly review the man pages to make them clearer. 37 - Improve the portability of test scripts by converting them from 38 GNU/Bash to the POSIX shell. 39 40 ### Version 0.4.2 41 42 Sets the required version of Star-SampPling to 0.12. 43 This version fixes compilation errors with gcc 11 but introduces API 44 breaks. 45 46 ### Version 0.4.1 47 48 Displays the time spent constructing the geometric distribution, writing 49 the sampled geometries, and performing the calculations. 50 51 ### Version 0.4 52 53 - Set the minimum number of scattering angles to 2 rather than the 54 previous and arbitrary limit fixed to 100. 55 - Fix a bug in the generation of the shape of the helical pipe. 56 - Update the short help of the command as well as the man pages. 57 - Add the `-D` option that discards all computations for large 58 scattering angles. 59 - Add the `--version` that prints the current version of the `schiff` 60 command. 61 62 ### Version 0.3.1 63 64 - Reformat the man pages. 65 66 ## License 67 68 Copyright (C) 2015, 2016, 2026 Centre National de la Recherche Scientifique 69 Copyright (C) 2026 Clermont Auvergne INP 70 Copyright (C) 2026 Institut Mines Télécom Albi-Carmaux 71 Copyright (C) 2017, 2019-2021, 2026 |Méso|Star> (contact@meso-star.com) 72 Copyright (C) 2026 Université de Lorraine 73 Copyright (C) 2026 Université de Toulouse 74 75 Schiff is free software released under the GPL v3+ license: GNU GPL 76 version 3 or later. You are welcome to redistribute it under certain 77 conditions; refer to the COPYING file for details.