Quick Start Tutorial
for Modelers and Developers

Build and Test Your First Workflow

As an open platform, L7|ESP offers near limitless options for customization and extension. This tutorial will quickly walk you through a simplified sequence of common "build tasks" that modelers and developers in L7|ESP perform. No coding skills are required to complete this.

Over the next 20 minutes, you will:
  • Create a simple Protocol that tracks values associated with Entities
  • Create a simple Pipeline that generates a Report after each Entity is processed
  • Create a Workflow that allows the Protocol and Pipeline to be used together to process Entities
  • Create a Project for managing Experiments
  • Register Entities and then use the registered Entities in an Experiment based on the Workflow
  • Update the Workflow to learn about versioning, data linking, and L7|ESP Expressions

Part 1

Create a Standard Protocol

that tracks values associated with Entities.

Steps
Show me
Deeper dive
In this section you will create a Standard Protocol to collect 260:280 ratios for nucleic acid Entities. This Standard Protocol will later be used when creating a Workflow.
  • Click the L7|Master app > Protocols > + New Protocol...
  • Enter "260:280 Quantification" in the Name field
  • Select No under the Use in manufacturing and select Standard Protocol as the Protocol Type.
  • Click + Add Field.
  • Enter "Type" in the Display Name field.
  • Select Picklist as the Type. Expand the Parameters section and enter "DNA" in the Enter option 0 field. Enter "RNA" in the Enter option 1 field.
  • Click + Add Field. (Observe that the Type field is saved and present in the Fields view and a new Field Details panel opens).
  • Enter "260:280 Ratio" in the Display Name field. Select Numbers only allowed as the Type.
  • Click Save
You now have a simple spreadsheet with three fields for data entry: a field to select the nucleic acid Entity type (i.e., DNA or RNA), a field to enter the measured ratio, and a default Complete field.
L7|ESP Help Center:
Empty space, drag to resize
L7 University:

Part 2

Create a Task for a Future Pipeline

that generates a Report after each Entity is processed.

Steps
Show me
Deeper dive
In this section you will create a Task that will use a bash shell script to perform a purity test to determine if the measured ratio is within the accepted range for the Entity material (i.e., DNA or RNA). This Task will later be used when creating a Pipeline.

Note:
Developers with programming abilities typically create Tasks and Pipelines in L7|ESP. 
  • From the Analysis app, click the Tasks tab.
  • Click + New Task.
  • Enter "260-280 Purity Test" in the Name field.
  • Copy the purity test code below (from line 1 to line 22).
  • Paste the purity test code into the Task View.
  • Click Save.
Observe that material and ratio have double curly braces around them, which denotes an L7|ESP Expression.

L7|ESP Expressions are based on the Python programming language and can be any single-line Python statement (with some security restrictions). Expressions are evaluated before a Task is executed, allowing you to supply parameters to Tasks (in this case, material and ratio) and to perform simple computations. For more information on expressions, refer to L7|ESP Expression Language.
L7|ESP Help Center:
Empty space, drag to resize
L7 University:

Part 3

Create a Registered File

which will track the result of the purity test.

Steps
Show me
Deeper dive
In this section you will create a Registered File, which will track the result of the purity test.
  • Register the result.html file generated by the Task by clicking + Add below Output Files.
  • Enter "Result Report" in the File Name field.
  • Enter html in the File Type field. 
  • Enter result.html in the Expression field. 
  • Click Save below the new file and in the top-right corner to save the updated Task. 
Every time the Task is executed, the result.html file generated in the Task directory is registered with L7|ESP and then added to the Task's provenance (and, by extension, the Pipeline's provenance and the Entity's provenance). To learn more about L7|ESP provenance system, refer to Provenance System.
L7|ESP Help Center:
Empty space, drag to resize
L7 University:

Part 4

Create a Pipeline

which will use the Task you created earlier, to generate quality control reports for DNA and RNA purification.

Steps
Show me
Deeper dive
In this section you will create a Pipeline, which will use the Task you created earlier, to generate quality control reports for DNA and RNA purification. This Pipeline will later be used to create a Pipeline Protocol.
  • From the Analysis app, click the Pipelines tab. Click + New Pipeline.
  • Enter "260:280 Purity Test" in the Name field. Click the blank Task box.
  • Start entering "260" and select "260-280 Purity Test" from the auto-complete list.
  • Click Save.

Test Pipeline

In this section you will test the new Pipeline you created.
  • Click Run.
  • Enter "DNA" for the material parameter. Enter "1.9" for the ratio parameter.
  • Click Run.
  • Click the Monitor tab. Click the "260:280 Purity Test" row for the DNA/1.9 run. The Pipeline Inspector on the right displays basic information about the executed Pipeline.
  • To navigate the results:

    Click the vertical ellipsis and then click View Details. This will redirect you to a page that looks similar to the Pipeline Builder. The key difference is that the Run Details page displays actual details from the run. Click the Task (the "260-280 Purity Test" box) to view run-time details, including associated Task Files. The Task Inspector on the right has links to the complete Task Script (as executed on the server); stderr and stdout for the script; and also a link to the Registered File, Result Report.
  • Click Result Report... to view the contents of the Registered File. You have now successfully tested the Pipeline.
L7|ESP Help Center:
Empty space, drag to resize
L7 University:

Part 5

Create a Pipeline Report

to display data from multiple Registered Files at once.

Steps
Show me
Deeper dive
The Pipeline and Registered File demonstrate how to create a simple Pipeline and make the results available in L7|ESP; however, locating and viewing Files generated by Pipelines through Run Details can be cumbersome, especially if the Pipeline generates many Files not used for Reports (e.g., such as those tracked for provenance purposes). Additionally, you may want to display data from multiple Registered Files at once. L7|ESP’s Report Builder provides such a service.

In this section you will use the Registered File to create a Report for the Pipeline.
  • From the Analysis app, click Pipelines. Click Edit on the 260:280 Purity Test row.
  • Click the Reports tab to access the Report Builder.
  • From the Report Elements list, drag "HTML file" to the canvas area and drop it on the Drag and drop a new report element here field.
  • From the Registered Files list, drag "Result Report (Step 1: 260-280)" to the canvas area and drop it on the Drag and drop a registered file here field.
  • Click Save.

Test Updated Pipeline

In this section you will test the updated Pipeline in order to see the new Report.
  • From the Analysis app, click the Pipelines tab. Click Run on the 260:280 Purity Test row.
  • Enter "RNA" for the material parameter. Enter "1.5" for the ratio parameter. Click Run.
  • Click the Monitor tab. Click the new "260:280 Purity Test" row for the RNA/1.5 run. Click View from the Pipeline Inspector on the right to view the RNA Report. The Report shows a failed RNA purity test.
 Important
From the Monitor tab, the first run (i.e., DNA/1.9) of the 260:280 Purity Test Pipeline does not have a Report associated with it, only the Registered Files. This absence is due to how L7|ESP versions Pipelines. When a Pipeline is run, the Pipeline Instance uses the current version of the Pipeline. If the Pipeline is updated later, only new Instances of the Pipeline will incorporate those updates. 
L7|ESP Help Center:
Empty space, drag to resize
L7 University:

Part 6

Create a Pipeline Protocol

to feed Entity data into the L7|ESP Pipeline system for computational analysis.

Steps
Show me
Deeper dive
In this section you will create a Pipeline Protocol using the Pipeline you previously created in order to feed Entity data into the L7|ESP Pipeline system for computational analysis.
  • Open the L7|Master app. Click Protocols from the Processes menu to access the Protocols page.
  • Click + New Protocol.
  • Enter "260:280 Report" in the Display Name field. Select No under Use in manufacturing. Select Pipeline Protocol as the Protocol Type. Select 260:280 Purity Test as the Pipeline.
  • Observe that two new fields appear in the Field View: material and ratio. These two new fields are for data entry, which will later be performed by filling out a Worksheet in the LIMS app.
  • Click anywhere in the material field. The material field will be highlighted in blue. In the Field Details panel, select Picklist as the Type. Expand the Parameters section and enter "DNA" in the Enter option 0 field. Enter "RNA" in the Enter option 1 field.
  • Click anywhere in the ratio field. Now the ratio field will be highlighted in blue. In the Field Details panel, select Numbers only allowed as the Type.
  • Click Save.
Result: You have now created a Standard Protocol and Pipeline Protocol, which will be used to create a Workflow.
L7|ESP Help Center:
Empty space, drag to resize
L7 University:

Part 7

Create a Workflow

that determines the purity of a DNA or RNA Entity using the 260:280 spectrophotometric ratio.

Steps
Show me
Deeper dive
In this section you will create a simple quality control Workflow that determines the purity of a DNA or RNA Entity using the 260:280 spectrophotometric ratio. The image below shows that this Workflow will have two Protocols: a Standard Protocol to collect the 260:280 ratio and a Pipeline Protocol to generate a quality control Report.
  • Open the L7|Master app. Click Workflows from the Processes menu.
  • Click + New Workflow.
  • Enter "260:280 Purity Assay" in the Display Name field. Select No under Use in manufacturing. Click and drag the 260:280 Quantification (from the Protocol Library panel) and drop in between the default Submitted and Completed boxes.
  • Click and drag the 260:280 Report (from the Protocol Library panel) and drop in between the 260:280 Quantification Protocol and the default Completed box.
  • Click Save.
L7|ESP Help Center:
Empty space, drag to resize
L7 University:

Part 8

Create a Project

in order to create an Experiment.

Steps
Show me
Deeper dive
In this section, you will create a Project. A Project is a collection of Experiments, grouped together for organizational purposes. You must create a Project before creating an Experiment.
  • Open the Projects app. Click + New Project.
  • Enter "Quick Start" as the Name.
  • Click Save.
L7|ESP Help Center:
Empty space, drag to resize
L7 University:

Part 9

Create an Experiment

and add/submit Entities to it.

Steps
Show me
Deeper dive
In this section you will add an Experiment to the Project you previously created, and add/submit Entities to the Experiment.
  • On the row of the Quick Start Project you just created, click + Experiment.
  • Verify that Workflow is selected. Select 260:280 Purity Assay from the Workflow drop-down. Enter "Hello Quick Start" as the Name. Click Next.
  • Click Add New Entities. Select Generic sample from the Entity Type drop-down. Enter "4" in the Number of Entities field. Verify that ESP SEQUENCE is selected from the Entity ID Sequence drop-down. Click Next.

    Note: Entity ID Sequence is used to generate Entity names automatically as Entities are added.

  • Click Save and Submit.
  • Click Submit Entities in the Submit Confirmation dialog.
Result: The Experiment (with four Entities) has been submitted to the LIMS app.
L7|ESP Help Center:
Empty space, drag to resize
L7 University:

Part 10

Create a Worksheet and Add Entities

that will later be used for data entry.

Steps
Show me
Deeper dive
In this section you will create a Worksheet and add the Entities from the Experiment you previously created to the Worksheet. This Worksheet will later be used for data entry.
  • Open the LIMS app. Click the icon to the right of Hello Quick Start (4) in the backlog. This will open the Add New Worksheet dialog.
  • Update the Name to "Quick Start Sheet 1".
  • Click Add Worksheet.
  • To view the Worksheet, click the Quick Start Sheet 1 link.
L7|ESP Help Center:
Empty space, drag to resize
L7 University:

Part 11

Process Entities and Perform Data Entry

Steps
Show me
Deeper dive
In this section you will practice processing Entities by performing data entry in the Worksheet you just created.
  • In the Type column, select "DNA," "DNA," "RNA," and "RNA" from the drop-down list.
  • In the 260:280 Ratio column, enter the values "1.7," "1.8," "1.9," and "2.0."
  • Select the "Complete" checkbox for each Entity.
  • Click Save and Continue.
  • In the Material column, select "DNA," "DNA," "RNA," and "RNA" from the drop-down list.
  • In the Ratio column, enter "1.7," "1.8," "1.9," and "2.0."
  • Click Save.
  • For the first Entity, click Start Pipeline to run the Pipeline that generates the Report. Click Run in the Run Pipeline dialog.
  • Entities can run simultaneously so click Start Pipeline and then Run in the Run Pipeline dialog for each of the remaining Entities. All Complete checkboxes will be checked and the Start column will say Done once the Pipelines are finished running.

    Note:
    To monitor Entities as they move through an Experiment, open the Projects app and click on the link for Hello Quick Start in the Experiments tab. Observe that the 4 Entities have advanced to the Completed stage.

    Click on the Protocol box for the 260:280 Report. Observe that the Reports are directly accessible from the Inspector. 
L7|ESP Help Center:
Empty space, drag to resize
L7 University:

Part 12

Link Data between Protocols

Steps
Show me
Deeper dive
Note:
For both Protocols in the Worksheet, you manually entered the same material and ratio values. Entering the same information twice creates an opportunity for data inconsistency - L7|ESP provides you with the tools to eliminate this risk. Values can be passed between Protocols in a Workflow using Data Links

In this section you will update the Workflow to automatically populate the Pipeline Protocol with values entered in the Standard Protocol.
  • Open the L7|Master app. Click Workflows from the Processes menu.
  • Click the 260:280 Purity Assay Workflow.
  • Click the 260:280 Report Protocol box. Click + Create for the material field to create a Data Link to connect the values in this Protocol to the values entered in the 260:280 Quantification Protocol.
  • In the Create Data Link dialog, select 260:280 Quantification as the Protocol. Select Type as the Column (the selected column is where the data will be linked). Click Add Below to generate an L7|ESP Expression based on the Protocol and Column selected. Click Save.

    Hint

    Note that the L7|ESP Expression Language previously used to create parameters when setting up the Pipeline can also be used in other parts of L7|ESP. In this case, you can set the value of the material field to be an Expression that references a value in another Protocol.

  • Click + Create for the ratio field.
  • In the Create Data Link dialog, select 260:280 Quantification as the Protocol. Select 260:280 Ratio as the Column. Click Add Below. Click Save.
  • Observe that both fields are now linked. Click Save to save the updated Workflow.
By following this Quick Start Tutorial, you have successfully created an Entity-to-result laboratory Workflow for DNA and RNA purity testing.
L7|ESP Help Center:
Empty space, drag to resize
L7 University:

Part 13

Test Updated Workflow

Steps
Show me
Deeper dive
To test your new L7|ESP knowledge and skills (as well as the Data Links), perform the steps below to test the updated Workflow.

  • Create a new Experiment under the Quick Start Project as follows:
    • Select the 260:280 Purity Assay Workflow.
    • Name the Experiment "Linked Quick Start."
    • Add 3 new Entities of type "Generic sample".
    • Submit the 3 Entities to the LIMS app.
  • Create a Worksheet for the Experiment named "Quick Start Sheet 2".
  • "Process" the 3 Entities and perform data entry as follows:
    • Open Quick Start Sheet
    • Enter values for Type and 260:280 Ratio in the 260:280 Quantification Protocol. 
    • Complete the 3 Entities to advance them to the next Protocol (i.e., 260:280 Report Protocol).
Result: The material and ratio values should have been pulled from the previous Protocol. This demonstrates that the Data Links are working.