ModelOp Center provides plugins into common data science development tools such as Rstudio, to allow data scientists to interact with ModelOp Center from their preferred development environment.

Introduction

ModelOp Center provides plugins into common data science development tools such as RStudio, to allow data scientists to interact with ModelOp Center from their preferred development environment.

Using ModelOp Center RStudio Plugin

RStudio (https://rstudio.com/) is a popular tool among data scientists and other users of R for building models. It includes a console, syntax-highlighting editor that supports direct code execution, as well as tools for plotting, history, debugging and workspace management. It comes in two formats: RStudio Desktop and RStudio Server. For the purposes of the interaction between ModelOp Center and RStudio we have the RStudio addin available which makes it easier to make some of the most useful operations directly in the user’s IDE of choice, in this case, RStudio notebook.

Installation and configuration instructions

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")

Watch out for when you just recently installed the package, you may need to restart the R session in order to see the package’s addins.

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.

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.
```
# 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
```
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.
```
Sys.setenv(MOC_INSTANCE_URL="http://modelop:8090")
```

ModelOp specific functions available within RStudio

RStudio provides an interface for the Addins that come with a package, they will be available in the “Addins” button in the IDE’s toolbar. Once installed, the RStudio interface is provided with the Addins section included in the “MODELOP” package with a set of operations that interact with ModelOp Center and will be expanded in the subsequent sections below.

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.

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.

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 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

From the “Addins” toolbar, select the option “Load ModelOp model“.
Select the desired model from the list or filter using the live search bar and click on LOAD.
The addin will then create new chunks at the bottom of the active document with the source code assets' contents (each asset on a new chunk).

Updating an existing model

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

Editing the source code

From the “Addins” toolbar, select the option “Save existing ModelOp model“.
Select the desired asset from the available model assets list or filter using the live search bar and click SAVE.
The Addin will update ModelOp Center with the updated code for the selected asset.

Updating model metadata fields 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

From the “Addins” toolbar, select the option “Add attachment“.
Select the model to attach the file(s) to.
Click on “Browse” to select the file(s) to attach.
Optionally, click a row of the file list to select and then remove from the list before submitting.
When ready click on ATTACH.
The Addin will upload the external file assets and attach them to the selected model.

Submit model version

From the “Addins” toolbar, select the option “Submit ModelOp model“.
Select the model to submit, the Addin will display the latest changes on the model. Click on SUBMIT when ready.
The action will create a ‘deployable’ model version with the current state of the model as known by ModelOp Center. Note that this may trigger a review, tests runs and/or deploy of the model depending on the specific Model LifeCycle implemented.

Table of Contents

Integrate with RStudio