The ModelOp Center (MOC) is flexible on how models are registered so that data scientists can leverage their preferred environments for model creation. In other words it is agnostic to the toolkit used to create the model.

ModelOp Center contains a package with the RStudio addin installation “tar.gz” file. Please contact your ModelOp representative to get the latest version.

Installation

These installation instructions assume the following:

• RStudio is already installed in any of the two formats: RStudio Desktop or RStudio Server.

• If you are installing from source code repository (as opposed to already having the tar.gz file).

  • Maven is already installed.

  • You have access to ModelOp’s rstudio-addin github repository.

If you don’t already have the tar.gz installable file but have access to the repository:

git clone https://github.com/modelop/rstudio-addin.git
cd rstudio-addin
mvn clean install

Then open RStudio or your R shell and make sure you have the required installation dependency: devtools

install.packages("devtools")

Install the ModelOp RStudio addin:

devtools::install_local("rstudio-addin-2.1-SNAPSHOT.tar.gz")

Configuration

Before being able to use the addin in your RStudio instance, please make sure your RStudio knows where your ModelOp Center can be reached by providing the base URL in either of the following ways.

1. Setting up the MOC_INSTANCE_URL environment variable with the base URL, e.g.: “http://modelop:8090” before running the RStudio Server or before opening RStudio Desktop (from a terminal). Please note for RStudio Server installations that the environment variables aren’t automatically passed to the instance, but rather need to be set in the .Renviron file. For simplistic purposes, we can achieve this as in the example below, but see here for details on R startup configuration.

   Code Block
   language bash
   # The following variable is assumed to be set for your environment export MOC_INSTANCE_URL=http://modelop:8090 # Then make sure to pass it to the .Renviron file before running your instance env | grep MOC_INSTANCE_URL > /home/rstudio/.Renviron # Now you can start the RStudio server sudo rstudio-server start

2. Even after started the RStudio you can modify (or set) the environment variable from within the R session to change the base ModelOp Center URL.

   Code Block
   language r
   Sys.setenv(MOC_INSTANCE_URL="http://modelop:8090")

Image Removed

Image Added

RStudio supported documents

In order for ModelOp Addin to function properly, the user is required to create or open an R Markdown (or R Notebook) document and work the model in such file.

Image Removed

Image Added

RStudio supports the use of R Markdown documents as an authoring framework for data science. They allow users to save and execute code as well as generate a high quality diverse output formats by mixing text document with code chunks. For more about R Markdown documents see here.

Info
The RStudio ModelOp Addin will assume you have an active (open and focused) R Markdown document in your workspace for the Addin to interact with.

ModelOp Addins work with an active R Markdown document by writing chunks into it or inspecting its chunks searching for associated ModelOp Center models. R Markdown chunks are fragments of source code delimited by lines with ```{r} and ``` embedded in an R Markdown document. Find out more about R Markdown chunks here.

Registering a new model

Status
title not supported

For the moment it is not possible to register a new model using the RStudio Addin. Please refer to the ModelOp alternatives to import a model into ModelOp Center

Opening an existing model

Select the desired model from the list or filter using the live search bar and click on LOAD.

Image Removed

There are multiple ways in which a model can be updated, depending on what you are ultimately achieving.

Editing the source code

1. From the “Addins” toolbar, select the option “Save existing ModelOp model“.

2. Select the desired asset from the available model assets list or filter using the live search bar and click SAVE.

   Image Removed

3. The Addin will update ModelOp Center with the updated code for the selected asset.

Updating model metadata fields

Status
title not supported

Currently editing the model metadata fields from within RStudio is not supported, please refer to the ModelOp Center UI for these operations.

Adding attachments

1. From the “Addins” toolbar, select the option “Add attachment“.

2. Select the model to attach the file(s) to.

3. Click on “Browse” to select the file(s) to attach.

4. Optionally, click a row of the file list to select and then remove from the list before submitting.

5. When ready click on ATTACH.

   Image Removed

6. The Addin will upload the external file assets and attach them to the selected model.

Submit model version

Select the model to submit, the Addin will display the latest changes on the model. Click on SUBMIT when ready.

Image Removed