:orphan:

########
Examples
########


.. raw:: html

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

.. thumbnail-parent-div-open

.. thumbnail-parent-div-close

.. raw:: html

    </div>

=================
Creating GS Files
=================


.. raw:: html

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

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates the workflow for creating a GS file from the ASEG file format, as well as how to add multiple associated datasets to the Survey. Specifically, this AEM survey contains the following datasets:">

.. only:: html

  .. image:: /examples/Creating_GS_Files/images/thumb/sphx_glr_plot_aseg_tempest_thumb.png
    :alt:

  :doc:`/examples/Creating_GS_Files/plot_aseg_tempest`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">ASEG-GDF (Tempest AEM)</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates the typical workflow for creating a GS file for an AEM survey in its entirety, i.e., the NetCDF file contains all related datasets together, e.g., raw data, processed data, inverted models, and derivative products. Specifically, this survey contains:">

.. only:: html

  .. image:: /examples/Creating_GS_Files/images/thumb/sphx_glr_plot_csv_skytem_thumb.png
    :alt:

  :doc:`/examples/Creating_GS_Files/plot_csv_skytem`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">CSV & Rasters: Multi-dataset Survey with Derivative Products</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to convert comma-separated values (CSV) data to the GS NetCDF format. Specifically this example includes:">

.. only:: html

  .. image:: /examples/Creating_GS_Files/images/thumb/sphx_glr_plot_csv_resolve_thumb.png
    :alt:

  :doc:`/examples/Creating_GS_Files/plot_csv_resolve`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">CSV (Resolve AEM)</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The raw data is in .dat format as exported by the Loupe. The inverted resistivity models come as a set of syn/dat/inv .XYZ files exported by Aarhus Workbench.">

.. only:: html

  .. image:: /examples/Creating_GS_Files/images/thumb/sphx_glr_plot_dat_loupe_thumb.png
    :alt:

  :doc:`/examples/Creating_GS_Files/plot_dat_loupe`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">DAT & XYZ (Loupe TEM)</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example, we demonstrate the workflow for creating a GS file from the GeoTIFF (.tif/.tiff) file format. This includes adding individual TIF files as single 2-D variables, as well as how to create a 3-D variable by stacking multiple TIF files along a specified dimension.">

.. only:: html

  .. image:: /examples/Creating_GS_Files/images/thumb/sphx_glr_plot_tifs_thumb.png
    :alt:

  :doc:`/examples/Creating_GS_Files/plot_tifs`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">GeoTIFFs (2D & 3D)</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Generate Metadata Templates">

.. only:: html

  .. image:: /examples/Creating_GS_Files/images/thumb/sphx_glr_plot_help_I_have_no_variable_metadata_thumb.png
    :alt:

  :doc:`/examples/Creating_GS_Files/plot_help_I_have_no_variable_metadata`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Help! I have no metadata</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="These magnetic data channels were pulled from the Wisconsin SkyTEM example in this repository to demonstrate the relatively simple case of gridded raster files. ">

.. only:: html

  .. image:: /examples/Creating_GS_Files/images/thumb/sphx_glr_plot_csv_magnetics_thumb.png
    :alt:

  :doc:`/examples/Creating_GS_Files/plot_csv_magnetics`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Magnetic Raster Dataset</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example supports data and models read from Aarhus Workbench XYZ files. What&#x27;s unique about these files is that metadata is embedded in the header of the data files, such as the electromagnetic gate times. ">

.. only:: html

  .. image:: /examples/Creating_GS_Files/images/thumb/sphx_glr_plot_xyz_workbench_to_netcdf_thumb.png
    :alt:

  :doc:`/examples/Creating_GS_Files/plot_xyz_workbench_to_netcdf`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Workbench XYZ</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /examples/Creating_GS_Files/plot_aseg_tempest
   /examples/Creating_GS_Files/plot_csv_skytem
   /examples/Creating_GS_Files/plot_csv_resolve
   /examples/Creating_GS_Files/plot_dat_loupe
   /examples/Creating_GS_Files/plot_tifs
   /examples/Creating_GS_Files/plot_help_I_have_no_variable_metadata
   /examples/Creating_GS_Files/plot_csv_magnetics
   /examples/Creating_GS_Files/plot_xyz_workbench_to_netcdf

=========================
Interacting With GS Files
=========================


.. raw:: html

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

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The GS standard organizes datasets and metadata within a Data Tree. In GSPy, this is implemented through accessors into Xarray DataTrees, Datasets, and DataArrays. This example demonstrates basic xarray functionality for exploring the data and metadata for each class type.">

.. only:: html

  .. image:: /examples/Interacting_With_GS_Files/images/thumb/sphx_glr_plot_xarray_methods_thumb.png
    :alt:

  :doc:`/examples/Interacting_With_GS_Files/plot_xarray_methods`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Basic Functionality</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Every Survey must have a coordinate reference system (CRS) defined and all datasets within the Survey adhere to the same CRS.">

.. only:: html

  .. image:: /examples/Interacting_With_GS_Files/images/thumb/sphx_glr_plot_coordinate_reference_systems_thumb.png
    :alt:

  :doc:`/examples/Interacting_With_GS_Files/plot_coordinate_reference_systems`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Coordinate Reference Systems</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /examples/Interacting_With_GS_Files/plot_xarray_methods
   /examples/Interacting_With_GS_Files/plot_coordinate_reference_systems


.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-gallery

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download all examples in Python source code: examples_python.zip </examples/examples_python.zip>`

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download all examples in Jupyter notebooks: examples_jupyter.zip </examples/examples_jupyter.zip>`


.. only:: html

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

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