A Monte Carlo ray tracer for the optical simulation of solar concentrating systems
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
images/userguide Add files via upload Oct 7, 2016
.gitignore Add LICENSE file and .gitignore May 11, 2015
LICENSE Add LICENSE file and .gitignore May 11, 2015
README.md Update README.md Sep 15, 2017




Tonatiuh release 2.2.4 is now available!

In this release some bugs have been solved. The most relevant one is a bugs in ShapeCAD instersection algorithm only visible in some operating systems. In addition, Pillbox distribution function removed from material errors in order to avoid some simulations errors by using this distribution function

Find the last release following this link: https://github.com/iat-cener/tonatiuh/releases/tag/v2.2.4

First workshop on Tonatiuh

First TONATIUH workshop, with title “An introduction to TONATIUH”, has been successfully delivered by Amaia Mutuberria, Senior researcher of CENER Solar Thermal Energy Department. The course was organized within the activities that are being performed in WP12 of STAGE STAE (STAGE-STE project, http://stage-ste.eu/, has received funding from the European Union´s Horizon FP7 under grant agreement nº 609837).

The workshop was online and took place on 16th and 17th of September, 3 hours course per day. It was a success with a mass participation: more than 20 attenders of 10 different countries.

The main aim of this workshop was to explain how to design and analyze different CSP technologies using TONATIUH. In this workshop R programming language was used for the post-processing of TONATIUH's simulation output files, in order to transform raw photon data into flux distributions estimates, and to present those fluxes estimates as graphs.

Advanced level workshop will take place coming soon (second week of November expected). The main aim of this webinar will be to introduce the users in the development of the source code. After these sessions the attendants will be able to modify the code of the tool and they will be able to develop new plug-ins for TONATIUH.

Mrs. Amaia Mutuberria is a CENER senior researcher with more than 8 years of experience in the field of design and development of software for CSP systems simulations.

Amaia had the cooperation of Mr. Juan Manuel Quintanilla, Researcher of CENER Solar Thermal Energy Department, making ready the examples done during the presentation.


The Tonatiuh project aims to create an open source, cutting-edge, accurate, and easy to use Monte Carlo ray tracer for the optical simulation of solar concentrating systems. It intends to advance the state-of-the-art of the simulation tools available for the design and analysis of solar concentrating systems, and to make those tools freely available to anyone interested in using and improving them. Some of the most relevant design goals of Tonatiuh are:

  • To develop a robust theoretical foundation that will facilitate the optical simulation of almost any type of solar concentrating systems.
  • To exhibit a clean and flexible software architecture, that will allow the user to adapt, expand, increase, and modify its functionalities with ease.
  • To achieve operating system independence at source level, and run on all major platforms with none, or minor, modifications to its source code.
  • To provide the users with an advanced and easy-of-use Graphic User Interface (GUI). Additional information on the rationale for this open source project, and on the goals, general characteristics, and current status of Tonatiuh is given in the two following videos. The first video is based on a Pecha Kucha presentation given by Dr. Manuel J. Blanco at the University of Seville in September 2008. Although, the audio track is in Spanish, the video is closed-captioned in Spanih, and subtitled in English. Information on how to use the close-caption/subtitle features of YouTube videos can be found here. The second video is based on an oral presentation of the paper entitled "Preliminary validation of Tonatiuh" given by Dr. Manuel J. Blanco on September 17th, at the 2009 International Energy Agency's SolarPACES Symposium, celebrated in Berlin, Germany.


The use of extended Open Inventor files to represent the "scene" (i.e. the solar concentrating system, the sunlight model, etc.) An advance and easy-to-use GUI providing:

  • 3D and tree views of the "scene" to simulate.
  • Handlers and manipulators to modify and query scene objects using 3D views.
  • Interface elements to manage the undo and redo of user actions.
  • Interface elements to define de type of Monte Carlo ray tracing to execute. A pervasive plugin architecture which allos the user to:
  • Add new sunlight models.
  • Add new geometric surfaces.
  • Add new reflective materials.
  • (planned) Add new refractive materials.
  • (planned) Add new photon map and other results analyzers, and post-processors.
  • (planned) Add new spectrum models.


As any other ambitious open source program, Tonatiuh uses and leverages on several existing open source libraries, and tools. The principal open source resources used by Tonatiuh are:

  • Digia Qt for the Graphic User Interface (GUI).
  • Coin3D Toolkit for 3D Graphics Visualization.
  • Marble generic geographical map widget and framework.
  • CPPUnit for testing the code. All these tools are used for developing Tonatiuh within the Eclipse IDE in a standard development environment used by the entire developing team.

Tonatiuh's output files format

From version 2.0.1 the format of the outputs of simulations has been changed to be more flexible for post-processing. You can find a description of the format Tonatiuh's output files format .

Citing Tonatiuh

These are some of the most relevant references:

  • Blanco, M., Mutuberria, A., Monreal, A., & Albert, R. (2011). Results of the empirical validation of Tonatiuh at Mini-Pegase CNRS-PROMES facility. Proc SolarPACES.
  • Blanco, M. J., Mutuberria, A., & Martinez, D. (2010). Experimental validation of Tonatiuh using the Plataforma Solar de Almería secondary concentrator test campaign data. In 16th annual SolarPACES symposium.
  • Blanco, M. J., Mutuberria, A., Garcia, P., Gastesi, R., & Martin, V. (2009). Preliminary validation of Tonatiuh SOLARPACES Symposium. Berlin, Germany.
  • Blanco, M. J., Amieva, J. M., & Mancillas, A. (2005, January). The Tonatiuh Software Development Project: An open source approach to the simulation of solar concentrating systems. In ASME 2005 International Mechanical Engineering Congress and Exposition (pp. 157-164). American Society of Mechanical Engineers.

Creative Commons License
This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License.