RubiR

RubiR

RubiR is a feature within Code Fusion on the Rubiscape platform to write your code in the R programming language for building models.

You can use RubiR as an independent node or connect it to your Reader node (dataset) or other algorithm nodes.

Notes:

  • You can use the RubiR node as a stand-alone node, or you can connect it to your Reader node (dataset) or other algorithm nodes.
  • You can connect a Reader before the RubiR node. The dataset columns of the Reader node appear on the left side of the RubiR Code Editor, but you cannot access them.
  • You can connect multiple predecessor nodes to RubiR. However, the output of all the predecessors is not available for your use in the RubiR node.
  • You can connect any algorithm after RubiR, but you cannot access the output of the RubiR node in the algorithm.

Writing Custom Code using RubiR

To write your custom code using RubiR, follow the steps given below.

  1. Create your algorithm flow. Refer to Building Algorithm Flow in a Workbook Canvas.
  2. Drag and drop RubiR on your workbook canvas.
  3. Connect RubiR to the required node in your algorithm flow.

    Notes:

    • You can connect a reader to RubiR but cannot access any of the features of the reader.
    • Alternatively, you can use RubiR as a stand-alone node without connecting to any other node.
  4. Select RubiR and in the Properties pane, click Configure.



    The fields/icons on the R configuration page are described in the table below.

    Icon/Field

    Description

    Available Input Variables

    • It displays the features (columns) present in the preceding task’s output. These features are stored in a variable named inputData, which is of dictionary data type.  
    • Dictionary is a data type that contains name-value pairs.
    • You can access the features in the inputData variable and process them to create your custom variables.
    • You can access all the features (columns) present in the preceding task and the index of each row in the inputData[] variable.
    • You can access a single feature (column) from the features present in a particular preceding task and the index of each row in the inputData[‘<column_name>’] variable.

    Custom Output Variables

    Currently Not available in RubiR.

    R Code Editor

    The R Code Editor helps you to enter your customized R code. Refer to Using R Code Editor.

    TRAINING REQUIRED

    Functionality is coming soon.

    Minimap
    • It is a small, scaled version of code editor window.
    • If selected, shows the overview of entire code area in top right corner of code editor window.
    Theme
    • It helps you to customize the code editor theme.
    • Following theme options are provided:
      • VS-Dark
      • VS-Light
      • High Contrast-Dark
      • High Contrast-Light
    By default VS-Dark theme is selected. 

       

    It helps you to maximize the Code Editor page.

    It saves the changes, closes the configuration page, and returns you to the workbook canvas

  5. Write your R code in the R Code Editor. Refer to Using R Code Editor.
  6. Click Save.
  7. To execute the code, Run the RubiR node.

After successful execution, a confirmation message is displayed. You can view the output of the custom component under View Log > Custom Component Log.

Using R Code Editor

In the R Code Editor, you can add your R code.
  • The input variables are stored in the form of a Dictionary data type inputData.
  • To print to the console, use print().
A sample R code is shown in the image below.



The table below explains the above code snippet.
Line of Code
Result
df1 <- data.frame("SN" = 1:2, "Age" = c(21,15), "Name" = c("John","Dora"))
It creates a data frame with the name x using the provided data.
Str(df1)
It displays the internal structure of the df1 object.
Print(df1)
It prints the data frame.

Writing Custom Functions to Access Data using RubiR

You can use custom functions in RubiR to

  • upload file to cloud storage
  • download file from cloud storage

The following sections explain these custom functions.

Uploading File to Cloud Storage

RubiR provides a custom function to upload files to the S3 server. The code syntax to upload a file to cloud storage is shown below.

filetoUpload = <Path of the local file to be uploaded to S3 server>

key = <Name and location on S3 server>

data = PUTFILE(filepath, key)

Downloading File from Cloud Storage

RubiR provides a custom function to download files stored on the S3 server. The code syntax to download a file from cloud storage is shown below.

key = <Path of the file on S3 server>

data = GETFILE(key)

The syntax to read the contents of the downloaded file is given below.

print(data)

Publishing RubiR Code

You can publish the RubiR code from a workbook and reuse it in another workbook or workflow. This feature is similar to publishing models in RubiStudio.

To publish RubiR code, follow the steps given below.

  1. Write the RubiR code as required. Refer to Writing Custom Code using RubiR.
  2. Run the RubiR node.
  3. After the node is successfully executed, select the node, click the vertical ellipsis (), and click Publish code.

 After the code is successfully published, a confirmation message is displayed. This code is listed under Reusable Codes on the Rubiscape Home page.


Notes:

  • The published code is also available under Reusable Codes in Code Fusion under rubistudio in the Task Pane of a workbook.
  • The name of the published RubiR node should be unique. If a RubiR code with the same name already exists, Rubiscape gives an error.

Reusing RubiR Code

The published RubiR code is available for reuse in workbooks and workflows in the same workspace.

To reuse a published code, follow the steps given below.

  1. Open the workbook or create a workbook. Refer to Opening a Workbook and Creating a Workbook.
  2. Click Reusable Codes under Code Fusion in rubistudio in the Task Pane.

    The available reusable codes are displayed as shown in the figure below.

  3. Double-click or drag-and-drop the node on the workbook canvas.
  4. To run the code, select the node, click the vertical ellipsis ( ), and click Run.


    • Related Articles

    • RubiR

      RubiR is a feature within Code Fusion on the Rubiscape platform to write your code in the R programming language for building models. You can use RubiR as an independent node or connect it to your Reader node (dataset) or other algorithm nodes. ...