Skip to main content
All CollectionsWorkflow Management Toolkit
Hands-on: Workflow for Microbial Transformation and Material Lineage View
Hands-on: Workflow for Microbial Transformation and Material Lineage View

On this tutorial, we'll explore how to work with a Worklist to create a material and then see its lineage to understand where it comes from.

D
Written by Daniela Alvarez
Updated over 3 weeks ago

Contents of this Article


Pre-requisites: Uploading a Workflow Definition

To start the process, we need to upload a pre-made Workflow Definition. To start, go to the corresponding library and click "Upload".

After selecting the file and clicking on "Submit" you will see the Definition with 10 steps:

For this example, we won't edit it, so we can click on "Publish". Then, go to the Workflow Runs library to proceed with the following steps.


Tutorial: Launching the Workflow Run

To launch it, click on the "New Workflow Run" option from the Workflow Runs library:

On the pop-up window, select the Workflow we just created:

After clicking on Launch, the Workflow Run is created.

Next, let's start the process. NOTE: Some steps will ask you how much of your materials you want to add (mL) there you need to consider your material volume, if you try to add more than what you have in your samples, the system will not let you continue with a warning indicating you exceeded the mL from your inventory.

1. Create Plate Map

The first tool creates a new plate map in your Inventory (this includes the format, materials to be held, and distribution patterns of the samples or aliquots contained). The step one should look like this:

The default plate format is 96 well, which we won't edit; on "item type" let's select "DNA Assembly Report" and select (...)

Then, a "select DNA Assembly Materials" option will appear, where we will use the "Entity type" filter to search for all primers and primary templates (we will select all the available options).

After hitting "Select DNA Assembly Materials", go to the next page, where a plate representation will be shown. There, click on "Distribute By" and select "Table order".

You may see a warning indicating that this option will clear the current placement and replace all items, click on next and your plate distribution will be ready:

Now, let's continue with the next step.

2. Plate Registration (Plate Maps)

This tool registers actual plates from plate maps created using the Create Plate Map tool. Notice that the plate map we made in the previous step is automatically selected.

After selecting the plate map, you will see the second step of this tool, where we will not edit anything. At the end, click on "Register Plate", and a barcode will be automatically generated.

3. PCR Planning and Inventory Check

This tool takes the reaction table generated on a selected DNA Assembly Report (which we will select on the first window). With the information contained on it, it will generate plate maps for left primer, right primer, and template sequence plates. To do it, select all PCR reactions.

With these reactions, the tool will automatically assign the PCR reactions to locations in a PCR plate. The algorithm will assign locations in a way that optimizes the PCR reactions when using a zone gradient thermocycler. This can be seen in the plate distribution scheme:

Next, a list will be displayed with the materials available in your inventory.

Notice that the materials that are not in inventory are not available to select, but will be shown in an order list.

Once this is done, we can continue with our PCR reaction.

4. Run PCR

This tool takes in plates (of templates, forward and reverse primers) and outputs a worklist and a reaction map specifying how those materials are used in the PCR reactions that generate assembly pieces that, in turn, will be used for DNA Assembly. The tool also outputs a destination PCR plate where the PCR reactions will take place.

Input plates will be automatically selected

5. Execute Worklist

This tool takes in one or more worklists with optional reaction maps to be executed in the lab. The tool validates that the source and destination materials both exist and have the appropriate volumes/capacity in the LIMS inventory. If the worklist is valid, executing the tool updates the effected plates in your lab's inventory.

During this step, there are two stages: 1. Select Worklist(s) (this will automatically be selected) and 2. Validate Worklist(s).

For the validation stage, you can see the verification information, including your reactions, inputs, outputs, and locations. After verifying all the information is correct, click on "Execute Worklist".

6. DNA Assembly Construct Selection

This tool allows you to select the DNA constructs you wish to build. You can choose constructs to build de novo from the DNA Assembly Report generated or check your inventory to use your existing materials. When working with this tool, click on "Select DNA Assembly Reports", this will show you the assembly pieces to select, where you can indicate the system which pieces you want to use.

After selecting the pieces, the system will show you the buildable constructs. Select the ones you want to use and click on "Submit".

7. DNA Assembly Reaction Planning

This tool takes in a list of constructs you want to make (for this case, the ones you indicated on step 6), as well as the plate containing the materials necessary to build them. It outputs a worklist and reaction map specifying how those materials need to be combined to make the constructs and outputs an empty plate prepared to accept those constructs. This tool is divided into three stages; for stage 1 you only need to select the constructs you actually want to build.

Notice that all the "Inputs" (PCR reactions) are written on a green color. This means all the materials are avaiilable in your inventory; in the case of unavailability of them, the system will indicate it to you with a red warning.

Next, on Stage 2 select the plate type (for this example we'll keep using the 96 well plate) and the volume you want to use for your transformation. Here, the integration with your inventory will also indicate you if you want to transfer more volume than it's available on your inventory, so you ensure all your reactions can be carried out successfully.

Stage 3 will show you a summary of your indications, once everything is set up, you can continue with the next step.

8. Execute Worklist

Just as in step 5 of this tutorial, the Execute Worlist Tool will validate the availability of your materials and that you have indicated appropriate volumes/capacity by checking your inventory. This step will automatically select the worklist, so you only have to keep going to go to the next step.

9. Microbial Transformation

This tool uses DNA and microbial materials as input to generate a worklist to combine them on a transformation reaction. This is divided into three stages: the first one will automatically select plates from your previous tasks, and in the second you will select a microbial material from your inventory, as well as the transfer volume you want to use for your material and DNA and select the destination plate, which will automatically be indicated.

Finally, the third stage of it will give you a transformation worklist and a reaction map as an output.

10. Execute Worklist

This tool, just like in steps 5 and 8, will go through your inventory to validate your materials and ultimately update the plates in your inventory. Once this final step is executed successfully, you will be able to go see your final output.


Final Output: Material Lineage

In the output of your final step, you will se the link to your microbial transformation plate with the updated wells containing the output of your transformation reaction. Notice that this plate is also new, since we created it using the first steps of our example.

On the plate information (which you can see when scrolling down) you can see the information of each of your new samples. Let's click in one of them:

This will lead you to the sample information window. Remember TeselaGen uses a hierarchy to classify your entities; on this case, this corresponds to a theoretical piece of information (it means it doesn't represent an actual physical material). However, the workflow indicated the system that this sequence actually exists in your inventory, which you can verify because it is already linked to a material. Let's click on it:

On the next page, you will be able to see the linked material of your sequence, with all its information.

If we scroll down a bit more, we will see the "material lineage" section. Let's explore it. On this section you can see the "parent materials", remember that this material comes from a microbial transformation reaction, which means that it was created from both a microbial and a DNA material, which are listed as parents.

On this case, we have only two parent materials, but imagine we have a longer list of them, or we want to track from the beginning all the materials we used to have this final output. To easilly do it, you can click on "View Graph" to see the graphic representation of the material lineage. Then, you will see something like this:

If you go back to the whole set of steps we followed, you'll notice that you can track everything from the very beginning to see how you worked with different materials to lead to this final output.

Did this answer your question?