Tutorial
=================

This tutorial will guide you through the process of creating your first stratigraphic log figure using stratapy. By the end of this tutorial, you will have a basic understanding of how to load data, create a log, and customise its appearance.

stratapy reads data from text-based files (like a ``.csv`` file or a spreadsheet ``.xlsx`` file). This tutorial will walk through the format of this file (:doc:`file_format`) before showing you how to create the log below and customise it.

.. Example files can be found at the bottom of this page, and the input files to reproduce all examples in this documentation are available in the :doc:`gallery <reference/gallery>`.

.. tip::
   You can follow along with the tutorial and the rest of the documentation using the complimentary Jupyter notebooks which you can `download here <https://github.com/your-repo/notebooks>`_.

.. raw:: html

   <div style="display: flex; justify-content: center; margin-top: 50px;">

.. card:: Get Started
   :link: file_format.html
   :link-type: url
   :width: 50%
   :text-align: center

   Learn how to format your data file and create your first log

.. raw:: html

   </div>   

.. figure:: /_static/figures/Tutorial.png
   :alt: stratapy Log Diagram
   :align: center
   :width: 60%

   Example log which you will learn to create in this tutorial.

.. toctree::
   :maxdepth: 1
   :hidden:
   
   file_format
   your_first_figure
   ../basic_log_formats/index