Analyse Your Data
Use our Python-based toolkit to explore how altitude, latitude, and solar activity influence radiation exposure during your flight
Take your seat
This Python-based educational toolkit was developed by the University of Cape Town and Observatoire de Paris.
Analysis workflow
Prepare detector data
Visualise radiation measurements
Reconstruct flight path
Analyse how radiation varies during the flight
Compare with models
In rare cases, your data may include real space weather effects.
What you’ll need
Python installed on your computer
A detector dataset and flight tracking data (or use the example provided)
Basic experience running Python code
Note: If using your own dataset, please upload to our Cosmic On Air database.
Pre-flight safety checks
Basic requirements
Python (version 3.9 or higher)
Make sure to enable “Add Python to PATH”
Terminal / command prompt basics
Introduction to command line https://tutorial.djangogirls.org/en/intro_to_command_line/
How to run your Python scripts https://realpython.com/run-python-scripts/
Install libraries
The toolkit relies on the following Python libraries:
numpy (version 1.20 or higher)
matplotlib (version 3.5 or higher)
cartopy (version 0.21 or higher, optional - used for map visualisation)
Install required packages:
(Optional - for maps)
Download the toolkit
pip install numpy matplotlib pip install cartopy
Take-off
Before using your own data, make sure your setup is working correctly:
Read the guide (also included as part of the toolkit).
Run through the steps 1 & 2 using the example data provided.
You should see a plot with the expected climb-cruise-descent structure like the one shown here.
Explore the example data set, and your try own measurements.
✈ You’re all set. Enjoy your flight! ✈
Cruise
Build on your first results with more data and advanced tools
Explore different flight conditions
Cape Town → Amsterdam
Long-haul, mid- to high-latitude, equatorial crossing
Reference dataset in toolkit
Houston → Paris
Transatlantic, mid- to high-latitude
Paris → Santiago
Long-haul, high- to low-latitude (southern hemisphere)
Paris → Tokyo
High-latitude, near-polar route
Explore more advanced analyses
For advanced users who want more control over plotting, dose conversion, and publication-quality output, you can explore the Jupyter notebook-based toolkit developed and maintained by researchers at the Observatoire de Paris.
Archive
Previous versions are available for reference