.. _Installation:

Installation for Matlab 
================================================



Matlab Client Setup
--------------------

1. Download the clients for JCMoptimizer from our `download page <https://optimizer.jcmwave.com/download>`_.
2. Extract the zip file and copy the package ``+jcmoptimizer`` in the ``matlab`` folder somewhere,
   for example in you home directory ``~/jcmoptimizer/matlab/+jcmoptimizer``.
3. For using the package inside Matlab, ``~/jcmoptimizer/matlab/`` must be a search path.
   To this end, add the line

   .. code-block::

      addpath("~/jcmoptimizer/matlab/");

   at the beginning of your Matlab scripts or inside the
   `Matlab starup script <https://de.mathworks.com/help/matlab/ref/startup.html>`_.




Using the Cloud Infrastructure
--------------------------------

The easiest and recommended way to use JCMoptimizer is to use our cloud infrastructure
to run servers and connect via a Matlab client. Here are the steps to get you going:

1. `Create a user account <https://optimizer.jcmwave.com/accounts/signup/>`_ on `https://optimizer.jcmwave.com <https://optimizer.jcmwave.com>`_.
   Consider to add a `two-factor authentication <https://optimizer.jcmwave.com/accounts/2fa/>`_ for increased security of your data.
2. Open the `cloud interface <https://optimizer.jcmwave.com/cloud/>`_ and on the left
   click on `Tokens <https://optimizer.jcmwave.com/cloud/tokens/list/>`_.
3. Press `Add token+` to create a new access token.
4. Copy the token and store it somewhere safe on your computer.
   You can put the token in the global configuration file of ``jcmoptimizer``.
   That is, open or create the file ``.jcmoptimizer.conf.yml`` in your home directory and enter a line

   .. code-block::
             
       token: <my token string>


Running a self-hosted JCMoptimizer
-----------------------------------

If you have a current license of our software package JCMsuite, you can run JCMoptimizer on your own computer infrastructure.

1. Download and run the JCMoptimizer installer from `here <https://optimizer.jcmwave.com/download>`_.
2. During the installation, you can create or update the configuration file ``.jcmoptimizer.conf.yml``
   in your home directory. If you want to this manually, the following two keys need to be set:

   :license_dir: 
      In order to run JCMoptimizer locally, an activated version of JCMsuite needs to be installed.
      You need to specify the path to the license configuration of the JCMsuite isntallation,
      for example
      
      .. code-block::
                
          license_dir: '/path/to/JCMsuite/license/'

       
   :jcm_optimizer_dir: To start a JCMoptimizer server locally, the ``jcmoptimizer`` Matlab package needs to know
     the installation directory ``jcm_optimizer_dir``:

     .. code-block::
             
         jcm_optimizer_dir: '/path/to/JCMoptimizer/'