MetaR Languages

MetaR logo

Installation instructions for MacOS users

System requirements

MetaR can be installed only if these requirements are met:

Install software required by MetaR

  1. Download and install Jetbrains MPS 2019.1.5 bundled with Java 8 (205 MB) from https://download-cf.jetbrains.com/mps/2019.1/MPS-2019.1.5-macos-jdk-bundled.dmg

  2. Install Docker Community Edition from https://store.docker.com/search?type=edition&offering=community (you need to register for the download).

    Depending on your machine’s system, follow the simple steps described on the download page to activate Docker on your system. Then, from the Terminal application, type the following command:

     docker pull artifacts/metar:latest
    

    then press enter/return. This will download a docker image we will use to execute MetaR analyses.

Install MetaR

  1. Install the MPS metaR plugin

    1.1 Start the MPS application and open-up the plugin manager in MPS (menu MPS > Preferences… > Plugins)

    1.2 Click on the top-right gear image and then select “Manage Plugin Repositories…” from the menu.

    Repo

    1.3 In the new window, click on the “+” button and add the following URL: http://mpsrepo.slisson.de/

    Repo

  2. Back on the “Plugins” window, click on “Marketplace” and search for “MetaR” and click on the install button of the plugin org.campagnelab.MetaR. Restart the application to activate the plugin.

    PluginInstall

  3. After restarting, open MPS, go back in the plugin manager (menu MPS > Preferences… > Plugins), select the “Installed” tab, and make sure the MetaR plugin is not listed red.

    PluginCheck

Configuration

  1. Define the following Path Variable (menu MPS>Preferences…>Appearance & Behavior>Path Variables):
    • Name: org.campagnelab.metaR.results_dir
    • Value: an arbitrary folder under /Users in Mac OS X where you want the results of MetaR analyses to be placed. (Avoid a path with spaces.)

    AddVariable

  2. Enable automatic reference re-resolution in the editor. For that, you need to enable the corresponding flag (“Automatically run reference resolve quick fixes”) on the Editor page in the Project settings (menu MPS>Preferences…>Editor> General) as shown:

    QuickRef