.. include:: ../links.inc

.. _installers:

AVNI installers
=====================

AVNI installers are the easiest way to install AVNI and all dependencies. They
also provide many additional Python packages and tools, including the `Spyder`_
development environment. Got any questions? Let us know on the `AVNI Forum`_!

.. tab-set::
    :class: platform-selector-tabset

    .. tab-item:: Linux
        :class-content: text-center
        :name: linux-installers

        .. button-link:: https://github.com/globalseismology/avni-installers/releases/download/v1.3.0/AVNI-1.3.0_0-Linux.sh
            :ref-type: ref
            :color: primary
            :shadow:
            :class: font-weight-bold mt-3

            |cloud-arrow-down| Download for Linux

        **Supported platforms:** Ubuntu 18.04 (Bionic Beaver) and newer

        Run the installer in a terminal via:

        .. code-block:: console

            $ sh ./AVNI-1.1.1_0-Linux.sh


    .. tab-item:: macOS (Intel)
        :class-content: text-center
        :name: macos-intel-installers

        .. button-link:: https://github.com/globalseismology/avni-installers/releases/download/v1.3.0/AVNI-1.3.0_0-macOS_Intel.pkg
            :ref-type: ref
            :color: primary
            :shadow:
            :class: font-weight-bold mt-3

            |cloud-arrow-down| Download for macOS (Intel)

        **Supported platforms:** macOS 10.15 (Catalina) and newer


    .. tab-item:: macOS (Apple Silicon)
        :class-content: text-center
        :name: macos-apple-installers

        .. button-link:: https://github.com/globalseismology/avni-installers/releases/download/v1.3.0/AVNI-1.3.0_0-macOS_M1.pkg
            :ref-type: ref
            :color: primary
            :shadow:
            :class: font-weight-bold mt-3

            |cloud-arrow-down| Download for macOS (Apple Silicon)


        **Supported platforms:** macOS 10.15 (Catalina) and newer

    .. tab-item:: Windows
        :class-content: text-center
        :name: windows-installers

        .. button-link:: https://github.com/globalseismology/avni-installers/releases/download/v1.3.0/AVNI-1.3.0_0-Windows.exe
            :ref-type: ref
            :color: primary
            :shadow:
            :class: font-weight-bold mt-3

            |cloud-arrow-down| Download for Windows

        **Supported platforms:** Windows 10 and newer


First steps
^^^^^^^^^^^

The installer adds menu entries on Linux and Windows, and several application
bundles to the ``Applications`` folder on macOS.

.. rst-class:: list-unstyled
.. rst-class:: mx-5
.. rst-class:: mt-4
.. rst-class:: mb-5

- |code| Use **Spyder** to start writing your own analysis scripts right away,
  or to run one of our examples from this website.

  .. rst-class:: mt-3
- |desktop| With **System Info**, list the versions of all installed
  AVNI-related packages.

  .. rst-class:: mt-3
- |terminal| The **Prompt** drops you into a command line interface with a
  properly activated AVNI environment.


.. note::
   |hourglass-half| Depending on your system, it may take a little while for these
   applications to start, especially on the very first run – which may take
   particularly long on Apple Silicon-based computers. Subsequent runs should
   usually be much faster.


VS Code Setup
^^^^^^^^^^^^^

If you want to use AVNI with `Visual Studio Code`_, you need to tell the VS Code
Python extension where to find the respective Python executable. To do so,
simply start the **Prompt**. It will display several lines of information,
including a line that will read something like:

.. code-block::

   Using Python: /some/directory/avni_1.0.0_1/bin/python

This path is what you need to enter in VS Code when selecting the Python
interpreter.

.. note::
   This information is currently not displayed on the Windows platform.


.. raw:: html

    <script type="text/javascript">
      var platform = "linux"; if (navigator.userAgent.indexOf("Win") !== -1) {
        platform = "windows";
      } if (navigator.userAgent.indexOf("Mac") !== -1) {
        // there's no good way to distinguish intel vs M1 in javascript so we //
        just default to showing the first of the 2 macOS tabs platform =
        "macos-intel";
      }
     $(document).ready(function(){
         let all_tab_nodes = document.querySelectorAll(
             '.platform-selector-tabset')[0].children;
         let input_nodes = [...all_tab_nodes].filter(
             child => child.nodeName === "INPUT");
         let tab_label_nodes = [...document.querySelectorAll('.sd-tab-label')];
         let correct_label = tab_label_nodes.filter(
             // label.id is drawn from :name: property in the rST, which must //
             be unique across the whole site (*sigh*) label =>
             label.id.startsWith(platform))[0];
         let input_id = correct_label.getAttribute('for'); let correct_input =
         input_nodes.filter(node => node.id === input_id)[0];
         correct_input.checked = true;
     }); </script>