SkinOptics documentation

SkinOptics is an open source Python package with tools for building human skin computational
models for Monte Carlo simulations of light transport, as well as tools for analyzing simulation
outputs. It can also be used for teaching and exploring about Optical Properties and Colorimetry.

SkinOptics is under continuos development.

New features may be available in the future.

Please remember that SkinOptics is available without any warranty.

API reference (Toolbox)

Installation

SkinOptics can be easily installed using pip (the package installer for Python).
To do so, write the following line in the command prompt:
$ pip install skinoptics

Prerequisite Packages

SkinOptics is structured based on other Python packages.
In order to be able to properly run it, please also install all of the following:

Modules

SkinOptics is currently composed of seven modules:

1- utils.py
Module with mathematical and auxiliary functions.
2- dataframes.py
Module with pandas DataFrames of the txt and csv files stored at the datasets folder.
3- absorption_coefficient.py
Module with functions for modeling the absorption coefficient and its related quantities.
4- scattering_cofficient.py
Module with functions for modeling the scattering coefficient and its related quantities.
5- anisotropy_factor.py
Module with functions for modeling the anisotropy factor and its related quantities.
6- refractive_index.py
Module with functions for modeling the refractive index and its related quantities.
7- colors.py
Module with functions for Colorimetry.

Jupyter Notebooks

Some ipynb files with usage examples will be available soon.

Source Code

SkinOptics scripts are publicly available in a GitHub repository.

License

SkinOptics is released under GNU General Public License v3.0:

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.

Citing SkinOptics

If SkinOptics is being useful for a presentation, publication or other purpose, please consider citing it.

Suggestion:

V. P. G., Lima. “SkinOptics documentation,” (2024).

BibTex entry:

@misc{Lima2024,
author = {V. P. G. Lima},
title = {{SkinOptics documentation}},
year = {2024},
}

Credits

This documentation is written in reStructuredText and was built with Sphinx.
It is displayed using the Furo Theme and is hosted in the plataform Read the Docs.
The favicon image is from OpenMoji.

References

References that were used to implement SkinOptics tools are stated in the API reference.

Author Information

Victor Porto Gontijo de Lima
Brazilian 🟩 🟨 🟦 ⬜
Research, Development & Innovation
MSc student in Theoretical and Experimental Physics
São Carlos Institute of Physics (IFSC)
University of São Paulo (USP)
contact e-mail: victorporto@ifsc.usp.br
Physicist (Technician)
Núcleo de Formação de Professores (NFP)
Federal University of São Carlos (UFSCar)
contact e-mail: victor.lima@ufscar.br

If you find any mistakes in the scripts or have any suggestions, feel free to send me a message! :)

Funding

The development of SkinOptics was only possible due to multiple sources of finance…
1- Grants from Brazilian government funding agencies:
  • process number 88887.631088/2021-00 (PROEX - CAPES) [MSc scholarship, 2021 - 2023]

  • process number 465360/2014-9 (INCT - CNPq) [Biophotonics Group]

  • process number 2014/50857-8 (INCT - FAPESP) [Biophotonics Group]

  • process number 2013/07276-1 (CePID CePOF - FAPESP) [Biophotonics Group]

2- My work with management, teaching, research and university extension as an employee of a higher education federal institution in Brazil:
  • currently at the Federal University of São Carlos (UFSCar)

  • previously at the Federal Institute of Education, Science and Technology of Brasília (IFB)

Acknowledgments

I would like to thank…

  • my MSc supervisor Lilian Tan Moriyama, who is guiding me throughout the amazing and intriguing field of Biophotonics and Biomedical Optics.

  • some colleagues Thereza Fortunato, Otávio Palamoni, Sofia Santos, Semira Silva, Johan Tovar, Maria Júlia Marques and Alessandra Lima, as well as professors Cristina Kurachi and Vanderlei Bagnato, for all aid and discussions.

  • my BSc supervisor Mariana Penna Lima Vitenti, who guided my first steps in the field of Scientific Computing.

  • my friend Arthur Willian, who always helps me to deal with computer-related issues (and many others).

  • all my friends, who I will not be able to list in full here without the risk of missing names and who bring joy even in the hard times.

  • my boyfriend Brinatti, with whom I share home and future.

  • my grandmas Maria and Eva, my grandpa Severo, my mom Rosana, my dad Silvério and my sister Amanda, who I love so much and who have always provided me with material conditions for living and studying.