:orphan:

#################
Tutorial in Julia
#################

.. set default highlighting language for this document:

.. highlight:: bash

**Joaquim F. Luis**:sup:`1`,
**Pål (Paul) Wessel**:sup:`2`

#. Universidade do Algarve, Faro, Portugal
#. SOEST, University of Hawai'i at Manoa

The purpose of this tutorial is to introduce users to the GMT Julia wrapper, outline the
GMT environment, and enable you to make several forms of graphics. We will not be able to
cover all aspects of GMT nor will we necessarily cover the selected topics in sufficient detail.
Nevertheless, it is hoped that the exposure will prompt the users to improve their GMT skills
after completion of this short tutorial.

Also, not all GMT module manuals have been converted to the verbose Julia syntax so some links
still redirect to the hard-core GMT man pages, whilst others direct users to Julia versions of
the translated GMT manuals. A *lost case* is the GMT Technical Reference that is so big/complete that it
will take long time to see a Julia version of it.

See the :doc:`install guide </install>`
for instructions and to make sure you have all required dependencies installed.
Alternatively, you can build GMT from source by following the
`building guide <https://github.com/GenericMappingTools/gmt/blob/master/BUILDING.md>`_.

See also the general information about `Julia <https://julialang.org/learning/getting-started/>`_
as well as the introduction to the Julia wrapper at
`Introduction <https://www.generic-mapping-tools.org/GMTjl_doc/documentation/general/introduction/index.html#introduction>`_
and the very recommendable
`Quick Learn <https://www.generic-mapping-tools.org/GMTjl_doc/documentation/general/quick_learn/index.html#quick_learn/>`_.
Complement with the instructions on how to
install `GMT.jl <https://github.com/GenericMappingTools/GMT.jl#install>`_

.. toctree::
    :maxdepth: 1

    session-1
    session-2
    session-3
    session-4
