scambio

Version 1.0.0-beta.

README

SCAMBIO (Solar Cell Analysis Made by Balancing Photon Input and Output) is a Python package to simulate solar cells according to the following detailed balance models:

Shockley & Queisser (1961): detailed-balance model of single-junction solar cells;
Luque & Marti (1997): detailed-balance model of solar cells with an infinitesimal intermediate band;
Levy & Honsberg (2008): detailed-balance model of solar cells with a finite-width intermediate band;

and their generalization to:

arbitrary absorption band widths;
arbitrary absorbance spectra;

published on Zenodo with DOI 10.5281/zenodo.13950132.

Installation

You can install SCAMBIO and its dependencies by executing:

pip install .

from its root directory, containing the setup.py file. Dependencies should be automatically installed by pip, but you can find their list in the requirements.txt.

Usage

The code has been written to be as easy to understand as possible. Studying the aforementioned references and the API documentation stored in the /docs/ folder should be enough to use it in an informed and appropriate way.

Examples may be found in the /tests/ folder, some of which reproduce results from the references above.

More detailed documentation on the methods might be added in the future.

Acknowledgement

The software has been developed in the context of the research project PhANTOM (Empowering Photovoltaics with Intermediate Band Chalcogenides: From Atoms to New Tailored Optoelectronic Materials), funded by the Italian Ministry of University and Research (MUR) through the National Recovery and Resilience Plan (PNRR) with the call Young Researchers - Seal of Excellence (CUP number: E13C22002920006).

CHANGES

1.0.0-beta - 15 Oct 2024

Added: Initial beta release with basic functionality.
Known issues: Some features may not work as expected. Please report any bugs (matteo.cagnoni@polito.it).

LICENSE

Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License

Conditions

You are free to copy and redistribute the material in any medium or format under the following terms:

Attribution: You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
NonCommercial: You may not use the material for commercial purposes.
NoDerivatives: If you remix, transform, or build upon the material, you may not distribute the modified material.

For the full text of the license, visit the official Creative Commons website.

Disclaimer

The software is provided "as is", without warranty of any kind, expressed or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement.

In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.

View Source

1r"""Version 1.0.0-beta.
2
3.. include:: ../README.md
4.. include:: ../CHANGES.md
5.. include:: ../LICENSE.md
6"""
7
8__version__ = "1.0.0-beta"