RxMix Tutorial

Introduction

RxMix is an interface for building applications that allows users to combine functions of the RxNorm, RxTerms, NDF-RT, RxClass and Interaction APIs. RxMix offers several notable features:
Users of the RxMix interface should be familiar with the RxNorm, NDF-RT, RxClass, Interaction and/or the RxTerms API functions.

RxMix video tutorials:
RxMix web page

Batch example

A Simple Example

This example illustrates the basic operations of the RxMix interface. In this example, we will build a workflow containing two functions in order to find what diseases/condition a drug treats using the NDF-RT API. We will run this workflow interactively.

The figure below shows the initial RxMix page.



The main panel is divided up into eight sections.
To define a workflow, first click on the arrow at the right side of the box under Select Function, and a menu of the available functions will be displayed like the figure below.



The menu of available functions shows the API (RxNorm, RxTerms or NDF-RT, RxImageAcess or Interaction) type and the names for each available function.

Scroll down to the NDF-RT functions and select the NDF-RT API function findConceptsByName. The workflow area is changed to the figure below.



The findConceptsByName function needs two parameters. The concept name parameter will be specified in the input data section. The other parameter, the kind name, is specified in the workflow area. RxMix provides a default value (all kinds are selected) for this field.
Note: The documentation for a selected function can be viewed by positioning the cursor over the help icon .


Uncheck all then select DRUG_KIND in the kind menu. Click the Add to Workflow button to add the function to the workflow. The workflow area is changed to the figure below.



Notice that a Remove Last button has appeared below the workflow diagram. This allows the last function in the workflow to be removed.

The next step is to add the second function to the workflow. From the function menu under NDF-RT, select getRelatedConceptsByRole. Under the Optional Parameters, select may_treat {NDFRT} from the role_type drop down menu.



Then click on the Add to Workflow button. The workflow is changed to the figure below.



The next step is to add the input data. The input for this workflow needs a drug name. Type in sotalol in the input box.



The Output Filter lists the fields to be included in the output.



Now click on the Run Interactive button in the EXECUTE section to start the processing. The results will be shown as a table (the output format selected) in the Output area.



Congratulations, you have created and run your first workflow in RxMix.

The next example will demonstrate the use of batch processing in RxMix. View the batch example.