BranchesTags

Repository files navigation

EasyCraterSim 1.2.2

DOI

EasyCraterSim is a lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations and methodologies described in the paper: O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104. This project aims to provide a simple and accessible visualization of crater growth dynamics based on fundamental physical parameters.

[https://easycratersim.streamlit.app/]

🛰️ Scientific objectives

  • Understand the processes involved in impact crater formation.
  • Model the transition between simple and complex craters (WIP)
  • Study the influence of physical parameters such as gravity, impactor velocity, surface strength, and planetary density.
  • Visualize the evolution of a crater profile over time, normalized by impactor diameter.

📊 Features

  • Choose pre-set crater types (Chicxulub, Meteor Crater, Tycho, Copernicus, and more).
  • Customize key physical parameters (gravity, impactor size, velocity, angle, temperature, etc.).
  • Visualize the crater shape at a specific time or animate its evolution.
  • Graphical output showing normalized radius and depth of the crater.
  • Download a GIF showcasing the evolution of the crater
  • Choose between Single Crater Simulation or Comparison Mode(WIP)
  • ReverseSimulation : Choose a crater and EasyCraterSim will estimate the impactor's parameters!
  • Guess the crater : A quick game where you have to guess the crater based on hints!

🧠 Work in progress

  • Comparison Mode : A new mode able to compare two craters, either side by side or by overlaying

🖼️ Interface Preview

EasyCraterSim Interface

🖥️ How to use

Enjoy the latest up-to-date version

The interface, using the latest version, is available here : [https://easycratersim.streamlit.app/]

Self hosting

If you want to host the interface by yourself

Prerequisites

Ensure you have the following installed:

  • Python 3.x
  • Streamlit
  • Matplotlib
  • Scipy
  • Numpy

Installation

pipinstallstreamlitmatplotlibscipynumpy

Running

streamlit run app.py

Accessing the interface

The direct link to your Streamlit interface should be directly displayed into the terminal where you entered the streamlit prompt.

⚙️ Context

This program was developed as part of the course unit 'Mathematical Modeling,' supervised by E. Léger and H. Massol, during my Bachelor's degree in 'Earth and Universe Sciences' at the University of Paris-Saclay. This project is based on the equations and impact crater formation models described in: O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.

📚 References

This project is based on scientific research on impact craters. Below are some key references:

  • Reimold, W. U., & Gibson, R. L. (2006). The Vredefort impact structure, South Africa. Geological Society of America Special Papers, 405, 1-28. DOI
  • Grieve, R. A. F., & Therriault, A. M. (2000). The Sudbury impact structure: A century of discovery and research. The Journal of Earth Sciences, 42(4), 339-362. DOI
  • Masaitis, V. L. (1998). Popigai crater: Origin and distribution of diamond-bearing impactites. Meteoritics & Planetary Science, 33(2), 349-359. DOI
  • Schulte, P., & et al. (2010). The Chicxulub asteroid impact and mass extinction at the Cretaceous-Paleogene boundary. Science, 327(5970), 1214-1218. DOI
  • Kring, D. A. (1997). Airblast produced by the Meteor Crater impact event and a reconstruction of the affected environment. Meteoritics & Planetary Science, 32(4), 517-530. DOI
  • Grotzinger, J. P., & et al. (2015). Deposition, exhumation, and paleoclimate of an ancient lake deposit, Gale crater, Mars. Science, 350(6257), aac7575. DOI
  • Smith, D. E., & et al. (1999). The global topography of Mars and implications for surface evolution. Science, 284(5419), 1495-1503. DOI
  • Petro, N. E., & Pieters, C. M. (2004). Surviving the heavy bombardment: Ancient material at the surface of South Pole-Aitken Basin. Journal of Geophysical Research: Planets, 109(E6). DOI
  • Head, J. W. (1974). The geology of the Copernicus Quadrangle of the Moon. US Geological Survey Professional Paper, 1049, 1-75. Link
  • Shoemaker, E. M. (1971). Impact mechanics at Tycho crater, in The Moon. Symposium 47 of the International Astronomical Union, 289-300. DOI

📄 Citation

If you use this project, please cite as follows:

SOARES CORREIA, M. (2025). EasyCraterSim : Lightweight numerical simulation tool to model the formation and evolution of impact craters (v1.2.1). Université Paris-Saclay. https://doi.org/10.5281/zenodo.14911870

📧 Contact

For questions or contributions: [maxime.soares-correia@universite-paris-saclay.fr]

📝 License

This project is licensed under the GNU GPL v3 License.

About

Lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations of O'Keefe (1999)

Topics

geologygeology-modellinggeophysical-modelinggeophysicsplanetology

Resources

Readme
AGPL-3.0 license
Activity

Stars

3 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
EasyCraterSim 1.2.2
DOI
EasyCraterSim is a lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations and methodologies described in the paper:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
This project aims to provide a simple and accessible visualization of crater growth dynamics based on fundamental physical parameters.
[https://easycratersim.streamlit.app/]
🛰️ Scientific objectives
  • Understand the processes involved in impact crater formation.
  • Model the transition between simple and complex craters (WIP)
  • Study the influence of physical parameters such as gravity, impactor velocity, surface strength, and planetary density.
  • Visualize the evolution of a crater profile over time, normalized by impactor diameter.
📊 Features
  • Choose pre-set crater types (Chicxulub, Meteor Crater, Tycho, Copernicus, and more).
  • Customize key physical parameters (gravity, impactor size, velocity, angle, temperature, etc.).
  • Visualize the crater shape at a specific time or animate its evolution.
  • Graphical output showing normalized radius and depth of the crater.
  • Download a GIF showcasing the evolution of the crater
  • Choose between Single Crater Simulation or Comparison Mode(WIP)
  • ReverseSimulation : Choose a crater and EasyCraterSim will estimate the impactor's parameters!
  • Guess the crater : A quick game where you have to guess the crater based on hints!
🧠 Work in progress
  • Comparison Mode : A new mode able to compare two craters, either side by side or by overlaying
🖼️ Interface Preview
EasyCraterSim Interface
🖥️ How to use
Enjoy the latest up-to-date version
The interface, using the latest version, is available here : [https://easycratersim.streamlit.app/]
Self hosting
If you want to host the interface by yourself
Prerequisites
Ensure you have the following installed:
  • Python 3.x
  • Streamlit
  • Matplotlib
  • Scipy
  • Numpy
Installation
pipinstallstreamlitmatplotlibscipynumpy
Running
streamlit run app.py

Accessing the interface
The direct link to your Streamlit interface should be directly displayed into the terminal where you entered the streamlit prompt.
⚙️ Context
This program was developed as part of the course unit 'Mathematical Modeling,' supervised by E. Léger and H. Massol, during my Bachelor's degree in 'Earth and Universe Sciences' at the University of Paris-Saclay.
This project is based on the equations and impact crater formation models described in:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
📚 References
This project is based on scientific research on impact craters. Below are some key references:
  • Reimold, W. U., & Gibson, R. L. (2006). The Vredefort impact structure, South Africa. Geological Society of America Special Papers, 405, 1-28. DOI
  • Grieve, R. A. F., & Therriault, A. M. (2000). The Sudbury impact structure: A century of discovery and research. The Journal of Earth Sciences, 42(4), 339-362. DOI
  • Masaitis, V. L. (1998). Popigai crater: Origin and distribution of diamond-bearing impactites. Meteoritics & Planetary Science, 33(2), 349-359. DOI
  • Schulte, P., & et al. (2010). The Chicxulub asteroid impact and mass extinction at the Cretaceous-Paleogene boundary. Science, 327(5970), 1214-1218. DOI
  • Kring, D. A. (1997). Airblast produced by the Meteor Crater impact event and a reconstruction of the affected environment. Meteoritics & Planetary Science, 32(4), 517-530. DOI
  • Grotzinger, J. P., & et al. (2015). Deposition, exhumation, and paleoclimate of an ancient lake deposit, Gale crater, Mars. Science, 350(6257), aac7575. DOI
  • Smith, D. E., & et al. (1999). The global topography of Mars and implications for surface evolution. Science, 284(5419), 1495-1503. DOI
  • Petro, N. E., & Pieters, C. M. (2004). Surviving the heavy bombardment: Ancient material at the surface of South Pole-Aitken Basin. Journal of Geophysical Research: Planets, 109(E6). DOI
  • Head, J. W. (1974). The geology of the Copernicus Quadrangle of the Moon. US Geological Survey Professional Paper, 1049, 1-75. Link
  • Shoemaker, E. M. (1971). Impact mechanics at Tycho crater, in The Moon. Symposium 47 of the International Astronomical Union, 289-300. DOI
📄 Citation
If you use this project, please cite as follows:
SOARES CORREIA, M. (2025). EasyCraterSim : Lightweight numerical simulation tool to model the formation and evolution of impact craters (v1.2.1). Université Paris-Saclay. https://doi.org/10.5281/zenodo.14911870
📧 Contact
For questions or contributions: [maxime.soares-correia@universite-paris-saclay.fr]
📝 License
This project is licensed under the GNU GPL v3 License.
About
Lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations of O'Keefe (1999)
Topics
geologygeology-modellinggeophysical-modelinggeophysicsplanetology
Resources
Readme
AGPL-3.0 license
Activity
Stars
3 stars
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
EasyCraterSim 1.2.2
DOI
EasyCraterSim is a lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations and methodologies described in the paper:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
This project aims to provide a simple and accessible visualization of crater growth dynamics based on fundamental physical parameters.
[https://easycratersim.streamlit.app/]
🛰️ Scientific objectives
  • Understand the processes involved in impact crater formation.
  • Model the transition between simple and complex craters (WIP)
  • Study the influence of physical parameters such as gravity, impactor velocity, surface strength, and planetary density.
  • Visualize the evolution of a crater profile over time, normalized by impactor diameter.
📊 Features
  • Choose pre-set crater types (Chicxulub, Meteor Crater, Tycho, Copernicus, and more).
  • Customize key physical parameters (gravity, impactor size, velocity, angle, temperature, etc.).
  • Visualize the crater shape at a specific time or animate its evolution.
  • Graphical output showing normalized radius and depth of the crater.
  • Download a GIF showcasing the evolution of the crater
  • Choose between Single Crater Simulation or Comparison Mode(WIP)
  • ReverseSimulation : Choose a crater and EasyCraterSim will estimate the impactor's parameters!
  • Guess the crater : A quick game where you have to guess the crater based on hints!
🧠 Work in progress
  • Comparison Mode : A new mode able to compare two craters, either side by side or by overlaying
🖼️ Interface Preview
EasyCraterSim Interface
🖥️ How to use
Enjoy the latest up-to-date version
The interface, using the latest version, is available here : [https://easycratersim.streamlit.app/]
Self hosting
If you want to host the interface by yourself
Prerequisites
Ensure you have the following installed:
  • Python 3.x
  • Streamlit
  • Matplotlib
  • Scipy
  • Numpy
Installation
pipinstallstreamlitmatplotlibscipynumpy
Running
streamlit run app.py

Accessing the interface
The direct link to your Streamlit interface should be directly displayed into the terminal where you entered the streamlit prompt.
⚙️ Context
This program was developed as part of the course unit 'Mathematical Modeling,' supervised by E. Léger and H. Massol, during my Bachelor's degree in 'Earth and Universe Sciences' at the University of Paris-Saclay.
This project is based on the equations and impact crater formation models described in:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
📚 References
This project is based on scientific research on impact craters. Below are some key references:
  • Reimold, W. U., & Gibson, R. L. (2006). The Vredefort impact structure, South Africa. Geological Society of America Special Papers, 405, 1-28. DOI
  • Grieve, R. A. F., & Therriault, A. M. (2000). The Sudbury impact structure: A century of discovery and research. The Journal of Earth Sciences, 42(4), 339-362. DOI
  • Masaitis, V. L. (1998). Popigai crater: Origin and distribution of diamond-bearing impactites. Meteoritics & Planetary Science, 33(2), 349-359. DOI
  • Schulte, P., & et al. (2010). The Chicxulub asteroid impact and mass extinction at the Cretaceous-Paleogene boundary. Science, 327(5970), 1214-1218. DOI
  • Kring, D. A. (1997). Airblast produced by the Meteor Crater impact event and a reconstruction of the affected environment. Meteoritics & Planetary Science, 32(4), 517-530. DOI
  • Grotzinger, J. P., & et al. (2015). Deposition, exhumation, and paleoclimate of an ancient lake deposit, Gale crater, Mars. Science, 350(6257), aac7575. DOI
  • Smith, D. E., & et al. (1999). The global topography of Mars and implications for surface evolution. Science, 284(5419), 1495-1503. DOI
  • Petro, N. E., & Pieters, C. M. (2004). Surviving the heavy bombardment: Ancient material at the surface of South Pole-Aitken Basin. Journal of Geophysical Research: Planets, 109(E6). DOI
  • Head, J. W. (1974). The geology of the Copernicus Quadrangle of the Moon. US Geological Survey Professional Paper, 1049, 1-75. Link
  • Shoemaker, E. M. (1971). Impact mechanics at Tycho crater, in The Moon. Symposium 47 of the International Astronomical Union, 289-300. DOI
📄 Citation
If you use this project, please cite as follows:
SOARES CORREIA, M. (2025). EasyCraterSim : Lightweight numerical simulation tool to model the formation and evolution of impact craters (v1.2.1). Université Paris-Saclay. https://doi.org/10.5281/zenodo.14911870
📧 Contact
For questions or contributions: [maxime.soares-correia@universite-paris-saclay.fr]
📝 License
This project is licensed under the GNU GPL v3 License.
About
Lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations of O'Keefe (1999)
Topics
geologygeology-modellinggeophysical-modelinggeophysicsplanetology
Resources
Readme
AGPL-3.0 license
Activity
Stars
3 stars
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
EasyCraterSim 1.2.2
DOI
EasyCraterSim is a lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations and methodologies described in the paper:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
This project aims to provide a simple and accessible visualization of crater growth dynamics based on fundamental physical parameters.
[https://easycratersim.streamlit.app/]
🛰️ Scientific objectives
  • Understand the processes involved in impact crater formation.
  • Model the transition between simple and complex craters (WIP)
  • Study the influence of physical parameters such as gravity, impactor velocity, surface strength, and planetary density.
  • Visualize the evolution of a crater profile over time, normalized by impactor diameter.
📊 Features
  • Choose pre-set crater types (Chicxulub, Meteor Crater, Tycho, Copernicus, and more).
  • Customize key physical parameters (gravity, impactor size, velocity, angle, temperature, etc.).
  • Visualize the crater shape at a specific time or animate its evolution.
  • Graphical output showing normalized radius and depth of the crater.
  • Download a GIF showcasing the evolution of the crater
  • Choose between Single Crater Simulation or Comparison Mode(WIP)
  • ReverseSimulation : Choose a crater and EasyCraterSim will estimate the impactor's parameters!
  • Guess the crater : A quick game where you have to guess the crater based on hints!
🧠 Work in progress
  • Comparison Mode : A new mode able to compare two craters, either side by side or by overlaying
🖼️ Interface Preview
EasyCraterSim Interface
🖥️ How to use
Enjoy the latest up-to-date version
The interface, using the latest version, is available here : [https://easycratersim.streamlit.app/]
Self hosting
If you want to host the interface by yourself
Prerequisites
Ensure you have the following installed:
  • Python 3.x
  • Streamlit
  • Matplotlib
  • Scipy
  • Numpy
Installation
pipinstallstreamlitmatplotlibscipynumpy
Running
streamlit run app.py

Accessing the interface
The direct link to your Streamlit interface should be directly displayed into the terminal where you entered the streamlit prompt.
⚙️ Context
This program was developed as part of the course unit 'Mathematical Modeling,' supervised by E. Léger and H. Massol, during my Bachelor's degree in 'Earth and Universe Sciences' at the University of Paris-Saclay.
This project is based on the equations and impact crater formation models described in:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
📚 References
This project is based on scientific research on impact craters. Below are some key references:
  • Reimold, W. U., & Gibson, R. L. (2006). The Vredefort impact structure, South Africa. Geological Society of America Special Papers, 405, 1-28. DOI
  • Grieve, R. A. F., & Therriault, A. M. (2000). The Sudbury impact structure: A century of discovery and research. The Journal of Earth Sciences, 42(4), 339-362. DOI
  • Masaitis, V. L. (1998). Popigai crater: Origin and distribution of diamond-bearing impactites. Meteoritics & Planetary Science, 33(2), 349-359. DOI
  • Schulte, P., & et al. (2010). The Chicxulub asteroid impact and mass extinction at the Cretaceous-Paleogene boundary. Science, 327(5970), 1214-1218. DOI
  • Kring, D. A. (1997). Airblast produced by the Meteor Crater impact event and a reconstruction of the affected environment. Meteoritics & Planetary Science, 32(4), 517-530. DOI
  • Grotzinger, J. P., & et al. (2015). Deposition, exhumation, and paleoclimate of an ancient lake deposit, Gale crater, Mars. Science, 350(6257), aac7575. DOI
  • Smith, D. E., & et al. (1999). The global topography of Mars and implications for surface evolution. Science, 284(5419), 1495-1503. DOI
  • Petro, N. E., & Pieters, C. M. (2004). Surviving the heavy bombardment: Ancient material at the surface of South Pole-Aitken Basin. Journal of Geophysical Research: Planets, 109(E6). DOI
  • Head, J. W. (1974). The geology of the Copernicus Quadrangle of the Moon. US Geological Survey Professional Paper, 1049, 1-75. Link
  • Shoemaker, E. M. (1971). Impact mechanics at Tycho crater, in The Moon. Symposium 47 of the International Astronomical Union, 289-300. DOI
📄 Citation
If you use this project, please cite as follows:
SOARES CORREIA, M. (2025). EasyCraterSim : Lightweight numerical simulation tool to model the formation and evolution of impact craters (v1.2.1). Université Paris-Saclay. https://doi.org/10.5281/zenodo.14911870
📧 Contact
For questions or contributions: [maxime.soares-correia@universite-paris-saclay.fr]
📝 License
This project is licensed under the GNU GPL v3 License.
About
Lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations of O'Keefe (1999)
Topics
geologygeology-modellinggeophysical-modelinggeophysicsplanetology
Resources
Readme
AGPL-3.0 license
Activity
Stars
3 stars
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
EasyCraterSim 1.2.2
DOI
EasyCraterSim is a lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations and methodologies described in the paper:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
This project aims to provide a simple and accessible visualization of crater growth dynamics based on fundamental physical parameters.
[https://easycratersim.streamlit.app/]
🛰️ Scientific objectives
  • Understand the processes involved in impact crater formation.
  • Model the transition between simple and complex craters (WIP)
  • Study the influence of physical parameters such as gravity, impactor velocity, surface strength, and planetary density.
  • Visualize the evolution of a crater profile over time, normalized by impactor diameter.
📊 Features
  • Choose pre-set crater types (Chicxulub, Meteor Crater, Tycho, Copernicus, and more).
  • Customize key physical parameters (gravity, impactor size, velocity, angle, temperature, etc.).
  • Visualize the crater shape at a specific time or animate its evolution.
  • Graphical output showing normalized radius and depth of the crater.
  • Download a GIF showcasing the evolution of the crater
  • Choose between Single Crater Simulation or Comparison Mode(WIP)
  • ReverseSimulation : Choose a crater and EasyCraterSim will estimate the impactor's parameters!
  • Guess the crater : A quick game where you have to guess the crater based on hints!
🧠 Work in progress
  • Comparison Mode : A new mode able to compare two craters, either side by side or by overlaying
🖼️ Interface Preview
EasyCraterSim Interface
🖥️ How to use
Enjoy the latest up-to-date version
The interface, using the latest version, is available here : [https://easycratersim.streamlit.app/]
Self hosting
If you want to host the interface by yourself
Prerequisites
Ensure you have the following installed:
  • Python 3.x
  • Streamlit
  • Matplotlib
  • Scipy
  • Numpy
Installation
pipinstallstreamlitmatplotlibscipynumpy
Running
streamlit run app.py

Accessing the interface
The direct link to your Streamlit interface should be directly displayed into the terminal where you entered the streamlit prompt.
⚙️ Context
This program was developed as part of the course unit 'Mathematical Modeling,' supervised by E. Léger and H. Massol, during my Bachelor's degree in 'Earth and Universe Sciences' at the University of Paris-Saclay.
This project is based on the equations and impact crater formation models described in:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
📚 References
This project is based on scientific research on impact craters. Below are some key references:
  • Reimold, W. U., & Gibson, R. L. (2006). The Vredefort impact structure, South Africa. Geological Society of America Special Papers, 405, 1-28. DOI
  • Grieve, R. A. F., & Therriault, A. M. (2000). The Sudbury impact structure: A century of discovery and research. The Journal of Earth Sciences, 42(4), 339-362. DOI
  • Masaitis, V. L. (1998). Popigai crater: Origin and distribution of diamond-bearing impactites. Meteoritics & Planetary Science, 33(2), 349-359. DOI
  • Schulte, P., & et al. (2010). The Chicxulub asteroid impact and mass extinction at the Cretaceous-Paleogene boundary. Science, 327(5970), 1214-1218. DOI
  • Kring, D. A. (1997). Airblast produced by the Meteor Crater impact event and a reconstruction of the affected environment. Meteoritics & Planetary Science, 32(4), 517-530. DOI
  • Grotzinger, J. P., & et al. (2015). Deposition, exhumation, and paleoclimate of an ancient lake deposit, Gale crater, Mars. Science, 350(6257), aac7575. DOI
  • Smith, D. E., & et al. (1999). The global topography of Mars and implications for surface evolution. Science, 284(5419), 1495-1503. DOI
  • Petro, N. E., & Pieters, C. M. (2004). Surviving the heavy bombardment: Ancient material at the surface of South Pole-Aitken Basin. Journal of Geophysical Research: Planets, 109(E6). DOI
  • Head, J. W. (1974). The geology of the Copernicus Quadrangle of the Moon. US Geological Survey Professional Paper, 1049, 1-75. Link
  • Shoemaker, E. M. (1971). Impact mechanics at Tycho crater, in The Moon. Symposium 47 of the International Astronomical Union, 289-300. DOI
📄 Citation
If you use this project, please cite as follows:
SOARES CORREIA, M. (2025). EasyCraterSim : Lightweight numerical simulation tool to model the formation and evolution of impact craters (v1.2.1). Université Paris-Saclay. https://doi.org/10.5281/zenodo.14911870
📧 Contact
For questions or contributions: [maxime.soares-correia@universite-paris-saclay.fr]
📝 License
This project is licensed under the GNU GPL v3 License.
About
Lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations of O'Keefe (1999)
Topics
geologygeology-modellinggeophysical-modelinggeophysicsplanetology
Resources
Readme
AGPL-3.0 license
Activity
Stars
3 stars
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
EasyCraterSim 1.2.2
DOI
EasyCraterSim is a lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations and methodologies described in the paper:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
This project aims to provide a simple and accessible visualization of crater growth dynamics based on fundamental physical parameters.
[https://easycratersim.streamlit.app/]
🛰️ Scientific objectives
  • Understand the processes involved in impact crater formation.
  • Model the transition between simple and complex craters (WIP)
  • Study the influence of physical parameters such as gravity, impactor velocity, surface strength, and planetary density.
  • Visualize the evolution of a crater profile over time, normalized by impactor diameter.
📊 Features
  • Choose pre-set crater types (Chicxulub, Meteor Crater, Tycho, Copernicus, and more).
  • Customize key physical parameters (gravity, impactor size, velocity, angle, temperature, etc.).
  • Visualize the crater shape at a specific time or animate its evolution.
  • Graphical output showing normalized radius and depth of the crater.
  • Download a GIF showcasing the evolution of the crater
  • Choose between Single Crater Simulation or Comparison Mode(WIP)
  • ReverseSimulation : Choose a crater and EasyCraterSim will estimate the impactor's parameters!
  • Guess the crater : A quick game where you have to guess the crater based on hints!
🧠 Work in progress
  • Comparison Mode : A new mode able to compare two craters, either side by side or by overlaying
🖼️ Interface Preview
EasyCraterSim Interface
🖥️ How to use
Enjoy the latest up-to-date version
The interface, using the latest version, is available here : [https://easycratersim.streamlit.app/]
Self hosting
If you want to host the interface by yourself
Prerequisites
Ensure you have the following installed:
  • Python 3.x
  • Streamlit
  • Matplotlib
  • Scipy
  • Numpy
Installation
pipinstallstreamlitmatplotlibscipynumpy
Running
streamlit run app.py

Accessing the interface
The direct link to your Streamlit interface should be directly displayed into the terminal where you entered the streamlit prompt.
⚙️ Context
This program was developed as part of the course unit 'Mathematical Modeling,' supervised by E. Léger and H. Massol, during my Bachelor's degree in 'Earth and Universe Sciences' at the University of Paris-Saclay.
This project is based on the equations and impact crater formation models described in:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
📚 References
This project is based on scientific research on impact craters. Below are some key references:
  • Reimold, W. U., & Gibson, R. L. (2006). The Vredefort impact structure, South Africa. Geological Society of America Special Papers, 405, 1-28. DOI
  • Grieve, R. A. F., & Therriault, A. M. (2000). The Sudbury impact structure: A century of discovery and research. The Journal of Earth Sciences, 42(4), 339-362. DOI
  • Masaitis, V. L. (1998). Popigai crater: Origin and distribution of diamond-bearing impactites. Meteoritics & Planetary Science, 33(2), 349-359. DOI
  • Schulte, P., & et al. (2010). The Chicxulub asteroid impact and mass extinction at the Cretaceous-Paleogene boundary. Science, 327(5970), 1214-1218. DOI
  • Kring, D. A. (1997). Airblast produced by the Meteor Crater impact event and a reconstruction of the affected environment. Meteoritics & Planetary Science, 32(4), 517-530. DOI
  • Grotzinger, J. P., & et al. (2015). Deposition, exhumation, and paleoclimate of an ancient lake deposit, Gale crater, Mars. Science, 350(6257), aac7575. DOI
  • Smith, D. E., & et al. (1999). The global topography of Mars and implications for surface evolution. Science, 284(5419), 1495-1503. DOI
  • Petro, N. E., & Pieters, C. M. (2004). Surviving the heavy bombardment: Ancient material at the surface of South Pole-Aitken Basin. Journal of Geophysical Research: Planets, 109(E6). DOI
  • Head, J. W. (1974). The geology of the Copernicus Quadrangle of the Moon. US Geological Survey Professional Paper, 1049, 1-75. Link
  • Shoemaker, E. M. (1971). Impact mechanics at Tycho crater, in The Moon. Symposium 47 of the International Astronomical Union, 289-300. DOI
📄 Citation
If you use this project, please cite as follows:
SOARES CORREIA, M. (2025). EasyCraterSim : Lightweight numerical simulation tool to model the formation and evolution of impact craters (v1.2.1). Université Paris-Saclay. https://doi.org/10.5281/zenodo.14911870
📧 Contact
For questions or contributions: [maxime.soares-correia@universite-paris-saclay.fr]
📝 License
This project is licensed under the GNU GPL v3 License.
About
Lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations of O'Keefe (1999)
Topics
geologygeology-modellinggeophysical-modelinggeophysicsplanetology
Resources
Readme
AGPL-3.0 license
Activity
Stars
3 stars
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
EasyCraterSim 1.2.2
DOI
EasyCraterSim is a lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations and methodologies described in the paper:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
This project aims to provide a simple and accessible visualization of crater growth dynamics based on fundamental physical parameters.
[https://easycratersim.streamlit.app/]
🛰️ Scientific objectives
  • Understand the processes involved in impact crater formation.
  • Model the transition between simple and complex craters (WIP)
  • Study the influence of physical parameters such as gravity, impactor velocity, surface strength, and planetary density.
  • Visualize the evolution of a crater profile over time, normalized by impactor diameter.
📊 Features
  • Choose pre-set crater types (Chicxulub, Meteor Crater, Tycho, Copernicus, and more).
  • Customize key physical parameters (gravity, impactor size, velocity, angle, temperature, etc.).
  • Visualize the crater shape at a specific time or animate its evolution.
  • Graphical output showing normalized radius and depth of the crater.
  • Download a GIF showcasing the evolution of the crater
  • Choose between Single Crater Simulation or Comparison Mode(WIP)
  • ReverseSimulation : Choose a crater and EasyCraterSim will estimate the impactor's parameters!
  • Guess the crater : A quick game where you have to guess the crater based on hints!
🧠 Work in progress
  • Comparison Mode : A new mode able to compare two craters, either side by side or by overlaying
🖼️ Interface Preview
EasyCraterSim Interface
🖥️ How to use
Enjoy the latest up-to-date version
The interface, using the latest version, is available here : [https://easycratersim.streamlit.app/]
Self hosting
If you want to host the interface by yourself
Prerequisites
Ensure you have the following installed:
  • Python 3.x
  • Streamlit
  • Matplotlib
  • Scipy
  • Numpy
Installation
pipinstallstreamlitmatplotlibscipynumpy
Running
streamlit run app.py

Accessing the interface
The direct link to your Streamlit interface should be directly displayed into the terminal where you entered the streamlit prompt.
⚙️ Context
This program was developed as part of the course unit 'Mathematical Modeling,' supervised by E. Léger and H. Massol, during my Bachelor's degree in 'Earth and Universe Sciences' at the University of Paris-Saclay.
This project is based on the equations and impact crater formation models described in:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
📚 References
This project is based on scientific research on impact craters. Below are some key references:
  • Reimold, W. U., & Gibson, R. L. (2006). The Vredefort impact structure, South Africa. Geological Society of America Special Papers, 405, 1-28. DOI
  • Grieve, R. A. F., & Therriault, A. M. (2000). The Sudbury impact structure: A century of discovery and research. The Journal of Earth Sciences, 42(4), 339-362. DOI
  • Masaitis, V. L. (1998). Popigai crater: Origin and distribution of diamond-bearing impactites. Meteoritics & Planetary Science, 33(2), 349-359. DOI
  • Schulte, P., & et al. (2010). The Chicxulub asteroid impact and mass extinction at the Cretaceous-Paleogene boundary. Science, 327(5970), 1214-1218. DOI
  • Kring, D. A. (1997). Airblast produced by the Meteor Crater impact event and a reconstruction of the affected environment. Meteoritics & Planetary Science, 32(4), 517-530. DOI
  • Grotzinger, J. P., & et al. (2015). Deposition, exhumation, and paleoclimate of an ancient lake deposit, Gale crater, Mars. Science, 350(6257), aac7575. DOI
  • Smith, D. E., & et al. (1999). The global topography of Mars and implications for surface evolution. Science, 284(5419), 1495-1503. DOI
  • Petro, N. E., & Pieters, C. M. (2004). Surviving the heavy bombardment: Ancient material at the surface of South Pole-Aitken Basin. Journal of Geophysical Research: Planets, 109(E6). DOI
  • Head, J. W. (1974). The geology of the Copernicus Quadrangle of the Moon. US Geological Survey Professional Paper, 1049, 1-75. Link
  • Shoemaker, E. M. (1971). Impact mechanics at Tycho crater, in The Moon. Symposium 47 of the International Astronomical Union, 289-300. DOI
📄 Citation
If you use this project, please cite as follows:
SOARES CORREIA, M. (2025). EasyCraterSim : Lightweight numerical simulation tool to model the formation and evolution of impact craters (v1.2.1). Université Paris-Saclay. https://doi.org/10.5281/zenodo.14911870
📧 Contact
For questions or contributions: [maxime.soares-correia@universite-paris-saclay.fr]
📝 License
This project is licensed under the GNU GPL v3 License.
About
Lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations of O'Keefe (1999)
Topics
geologygeology-modellinggeophysical-modelinggeophysicsplanetology
Resources
Readme
AGPL-3.0 license
Activity
Stars
3 stars
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
EasyCraterSim 1.2.2
DOI
EasyCraterSim is a lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations and methodologies described in the paper:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
This project aims to provide a simple and accessible visualization of crater growth dynamics based on fundamental physical parameters.
[https://easycratersim.streamlit.app/]
🛰️ Scientific objectives
  • Understand the processes involved in impact crater formation.
  • Model the transition between simple and complex craters (WIP)
  • Study the influence of physical parameters such as gravity, impactor velocity, surface strength, and planetary density.
  • Visualize the evolution of a crater profile over time, normalized by impactor diameter.
📊 Features
  • Choose pre-set crater types (Chicxulub, Meteor Crater, Tycho, Copernicus, and more).
  • Customize key physical parameters (gravity, impactor size, velocity, angle, temperature, etc.).
  • Visualize the crater shape at a specific time or animate its evolution.
  • Graphical output showing normalized radius and depth of the crater.
  • Download a GIF showcasing the evolution of the crater
  • Choose between Single Crater Simulation or Comparison Mode(WIP)
  • ReverseSimulation : Choose a crater and EasyCraterSim will estimate the impactor's parameters!
  • Guess the crater : A quick game where you have to guess the crater based on hints!
🧠 Work in progress
  • Comparison Mode : A new mode able to compare two craters, either side by side or by overlaying
🖼️ Interface Preview
EasyCraterSim Interface
🖥️ How to use
Enjoy the latest up-to-date version
The interface, using the latest version, is available here : [https://easycratersim.streamlit.app/]
Self hosting
If you want to host the interface by yourself
Prerequisites
Ensure you have the following installed:
  • Python 3.x
  • Streamlit
  • Matplotlib
  • Scipy
  • Numpy
Installation
pipinstallstreamlitmatplotlibscipynumpy
Running
streamlit run app.py

Accessing the interface
The direct link to your Streamlit interface should be directly displayed into the terminal where you entered the streamlit prompt.
⚙️ Context
This program was developed as part of the course unit 'Mathematical Modeling,' supervised by E. Léger and H. Massol, during my Bachelor's degree in 'Earth and Universe Sciences' at the University of Paris-Saclay.
This project is based on the equations and impact crater formation models described in:
O'Keefe, J. D., & Ahrens, T. J. (1999). Complex craters: Relationship of stratigraphy and rings to impact conditions. Journal of Geophysical Research: Planets, 104(E11), 27091-27104.
📚 References
This project is based on scientific research on impact craters. Below are some key references:
  • Reimold, W. U., & Gibson, R. L. (2006). The Vredefort impact structure, South Africa. Geological Society of America Special Papers, 405, 1-28. DOI
  • Grieve, R. A. F., & Therriault, A. M. (2000). The Sudbury impact structure: A century of discovery and research. The Journal of Earth Sciences, 42(4), 339-362. DOI
  • Masaitis, V. L. (1998). Popigai crater: Origin and distribution of diamond-bearing impactites. Meteoritics & Planetary Science, 33(2), 349-359. DOI
  • Schulte, P., & et al. (2010). The Chicxulub asteroid impact and mass extinction at the Cretaceous-Paleogene boundary. Science, 327(5970), 1214-1218. DOI
  • Kring, D. A. (1997). Airblast produced by the Meteor Crater impact event and a reconstruction of the affected environment. Meteoritics & Planetary Science, 32(4), 517-530. DOI
  • Grotzinger, J. P., & et al. (2015). Deposition, exhumation, and paleoclimate of an ancient lake deposit, Gale crater, Mars. Science, 350(6257), aac7575. DOI
  • Smith, D. E., & et al. (1999). The global topography of Mars and implications for surface evolution. Science, 284(5419), 1495-1503. DOI
  • Petro, N. E., & Pieters, C. M. (2004). Surviving the heavy bombardment: Ancient material at the surface of South Pole-Aitken Basin. Journal of Geophysical Research: Planets, 109(E6). DOI
  • Head, J. W. (1974). The geology of the Copernicus Quadrangle of the Moon. US Geological Survey Professional Paper, 1049, 1-75. Link
  • Shoemaker, E. M. (1971). Impact mechanics at Tycho crater, in The Moon. Symposium 47 of the International Astronomical Union, 289-300. DOI
📄 Citation
If you use this project, please cite as follows:
SOARES CORREIA, M. (2025). EasyCraterSim : Lightweight numerical simulation tool to model the formation and evolution of impact craters (v1.2.1). Université Paris-Saclay. https://doi.org/10.5281/zenodo.14911870
📧 Contact
For questions or contributions: [maxime.soares-correia@universite-paris-saclay.fr]
📝 License
This project is licensed under the GNU GPL v3 License.
About
Lightweight numerical simulation tool designed to model the formation and evolution of impact craters based on the equations of O'Keefe (1999)
Topics
geologygeology-modellinggeophysical-modelinggeophysicsplanetology
Resources
Readme
AGPL-3.0 license
Activity
Stars
3 stars
Watchers
1 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages