20

Distribution of (Split and Pool) PCR reactions
The following is a step-by-step example of how to use j5 to distribute (split and pool) PCR reactions in multi-well plate across a thermocycler block annealing temperature gradient. This example uses the stand alone simplified web interface for j5.

[Please refer to the "Running a downstream automation design on the j5 server" section in the DeviceEditor user's manual for information concerning how the process can be accomplished using DeviceEditor.]

Following the previous example of how to use j5 to aggregate assembly files into a single condensed assembly file, this example shows how to take a condensed j5 assembly file (or even a non-condensed assembly file coming directly out of a  SLIC/Gibson/CPEC/SLiCE, combinatorial SLIC/Gibson/CPEC/SLiCE, Golden Gate, or combinatorial Golden Gate assembly design process), and design a multi-well plate arrangement of the requisite PCR reactions (potentially in split and pool mode), as well as the optimal thermocycler block (gradient) annealing temperature(s), with high-throughput liquid-handling robotics platforms in mind.

Here is an example set of PCR reactions (with indicated optimal annealing temperatures) that we might like j5 to distribute across a thermocycler block gradient for us:


Step 1 - Create the source plate list file and the zipped plate files file:

Once we have the j5 assembly file (e.g. myassemblyfilelist_condensed.csv, below) for which we'd like to distribute the PCR reactions across a multi-well plate, we need to create two input files for j5, the source plate list file and the zipped plate files file.  Using an existing source plate list file as a starting point (e.g. plate_list.csv), we can use MS Excel, another spreadsheet program, or even a text editor, to create our source plate list CSV file (stylized for clarity, click to view larger version):

Here is the actual csv file (plate_list.csv):

In this particular example, we'll have one source plate file "oligos_plate.csv" that will describe a multi-well plate containing the oligos required for our assembly, another source plate file "templates_plate.csv" that similarly describes a plate containing the PCR templates for our assembly, and a third source plate "PCR_mix_tubes.csv" that similarly describes a plate (albeit more like a 24 microfuge tube rack) containing a tube of the PCR master mix. You can use these three files (you can find them contained within the zippled_plates.zip file below) as template starting points for your future use, modifying them to suit your needs with MS Excel, another spreadsheet program, or even a text editor. The organization of the oligos, PCR templates, and PCR master mix in the multi-well source plates is not important; you can arrange them how ever you like (or how they came arrayed in 96-well format from a DNA oligo synthesis company such as IDT or Bioneer).
Now, we make a zip file that contains all of the source plate files (zipped_plates.zip):

Step 2 - Make any modifications to the downstream automation assembly parameters that you require:

The default values for the downstream automation parameters will be appropriate for a 96-well format PCR setup, using a thermocycler block similar the one depicted above that has six annealing temperature zones (with adjacent zones that must be within 5 degrees C of each other). If your thermocycler is not 96-well format, you don't have the capacity to do annealing temperature gradients (or if your machine has a different configuration), or if you would like to make other modifications (such as changing the minimal liquid volume that you or your robot can accurately pipette), download the following template input file:
Downstream automation parameters file (downstream_automation_parameters.csv):

and use MS Excel, another spreadsheet program, or even a text editor, to modify the downstream automation parameters, as you see fit.

Step 3 - Use j5 to distribute the PCR reactions:

Follow the directions on the stand alone simplified web interface documentation page for using j5 to distribute PCR reactions. Note that there are two variations: 1) a regular Distribute PCR reactions, and 2) a Distribute Split and Pool PCR Reactions. The second variation is especially useful for setting up 1-part CPEC assembly reactions, or for other types of PCR reactions (like quick change) in which the two primers are highly homologous to each other. For the purposes of this example, the input files you will upload are:

Downstream automation parameters file (downstream_automation_parameters.csv):
Source plate list file (plate_list.csv):
Zipped source plate files file (zipped_plates.zip):
j5 assembly file (myassemblyfilelist_condensed.csv):

Here is are two representative zip files resulting from this particular distribute PCR reactions example:
Regular Distribute PCR reactions (j5_Njhillson_20140501171201b5UQ.zip);
Distribute Split and Pool PCR Reactions (j5_Njhillson_20140501171239npjA.zip):

Step 4 - Check the resulting distribute PCR reactions files:

Opening the distribute PCR reactions file with a spreadsheet program such as Excel or OpenOffice provides a glance at the designed arrangement of the PCR reactions in the multi-well plate, as well as the designed optimal annealing temperature(s) of the thermocycler block (see the distribute PCR reactions file documentation for more information).

Here are the distribute PCR reactions file for this particular example using the identical input files as listed above:
Regular Distribute PCR reactions (myassemblyfilelist_condensed_distribute_pcr.csv);
Distribute Split and Pool PCR Reactions (myassemblyfilelist_condensed_distribute_pcr_pool.csv):

Note that the arrangements of the 18 (regular or pooled) PCR reactions and the thermocycler zone annealing temperature gradient in this file matches that shown schematically in the figure above.

j5 will also output PR-PR configuration files. These files are related to the distribute PCR reactions file, but are distinct in that there is a separate PR-PR configuration file for each PCR plate to be prepared, and they currently include JBEI robot-specific configurations that can be modified as needed to suit other institutional configurations. See the PR-PR configuration file documentation for more information).

Here is the PR-PR configuration file for this particular example using the identical input files as listed above:
Regular Distribute PCR reactions (myassemblyfilelist_condensed_distribute_pcr_PR_PR_1.pr);
Distribute Split and Pool PCR Reactions - Split (myassemblyfilelist_condensed_distribute_pcr_split_PR_PR_1.pr):
Distribute Split and Pool PCR Reactions - Pool (myassemblyfilelist_condensed_distribute_pcr_pool_PR_PR_1.pr):

Step 5 - Check the resulting updated plate list and zipped plate files files:

You will note that the resulting plate list file and the zipped plate files file have been updated.

The plate list file now additionally contains entries for any new PCR plates.

In addition, the liquid volumes of the oligos, templates, and PCR mix used in setting up the PCR plates have been subtracted from the source plates.

In this particular example, the PCR template "pj5_00001" started out in the source plate with 200 uL, but after 10 uL being dispensed in to each of 10 PCR reactions, 100 uL remains available. If we had attempted more of "pj5_00001" template than the well had contained, j5 would have returned an error message. This is a useful precaution against not having enough available PCR template, oligos, etc., available in the source plate to set up all of the PCR reactions. If each well can hold a maximum volume, say 1000 uL, it is possible to fill more than one source well with the same PCR template or oligo.

The new plate files in the resulting zipped plate files file are those corresponding to any new PCR plates.

That's it!