:orphan:

Basic Examples
==============

This gallery contains foundational examples for the Mineye-Terranigma project, demonstrating
core workflows in 3D geological modeling and geophysical forward modeling using GemPy.

Gallery Overview
----------------

These examples introduce the fundamental concepts and workflows needed for geological modeling
and geophysical analysis. They are designed to be accessible to users new to implicit geological
modeling while providing sufficient detail for advanced applications.

Prerequisites
-------------

* Basic understanding of geological concepts (stratigraphy, structural geology)
* Familiarity with Python programming
* Knowledge of geophysical methods (for gravity/magnetics examples)
* Installed packages: ``gempy``, ``gempy-viewer``, ``numpy``, ``matplotlib``, ``geopandas``

Example Progression
-------------------

The examples build upon each other in increasing complexity:

1. **Simple Geological Model**: Learn the basics of 3D implicit modeling with GemPy.
2. **Complex Geological Model**: Model more intricate structures like the Tharsis pluton.
3. **Forward Gravity Model**: Apply geophysical forward modeling to geological structures.

Data and Configuration
----------------------

All examples use real data from the Tharsis mining district in Spain. Data paths are
managed through the ``mineye.config.paths`` module, making it easy to adapt examples
to your own projects.

Getting Help
------------

* Check the API reference for detailed function documentation
* Review the installation guide if you encounter dependency issues
* Visit the project repository for issues and discussions



.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example creates a simple 3D geological model of the Tharsis region using GemPy.">

.. only:: html

  .. image:: /examples_basic/images/thumb/sphx_glr_01_simple_tharsis_model_thumb.png
    :alt:

  :ref:`sphx_glr_examples_basic_01_simple_tharsis_model.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Simple Geological Model - Tharsis Region</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example creates a complex 3D geological model of the Tharsis region using GemPy, demonstrating how to model erosive contacts between igneous intrusions and sedimentary sequences.">

.. only:: html

  .. image:: /examples_basic/images/thumb/sphx_glr_02_complex_tharsis_model_thumb.png
    :alt:

  :ref:`sphx_glr_examples_basic_02_complex_tharsis_model.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Complex Geological Model - Tharsis Region</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates forward gravity modeling using a 3D geological model. We compute the gravity response of the geological structure at real measurement locations.">

.. only:: html

  .. image:: /examples_basic/images/thumb/sphx_glr_03_gravity_forward_model_thumb.png
    :alt:

  :ref:`sphx_glr_examples_basic_03_gravity_forward_model.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Forward Gravity Modeling - Tharsis Region</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /examples_basic/01_simple_tharsis_model
   /examples_basic/02_complex_tharsis_model
   /examples_basic/03_gravity_forward_model



.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_