Before you start
- Have Trellis running: on a lab server, or on your own computer for practice (install).
- Load the demo. It adds two teaching labs, their accounts and example work in every module, and leaves your lab's own records alone. On the server, in the Trellis folder:
demo/demo.sh load
- Sign in as
demo, passwordtrellis-demo(or the one set withDEMO_PASSWORD).
To start the walkthrough again from a clean slate, run demo/demo.sh reset. The recordings are silent; each step is named in the green caption at the bottom.
Open a sequence
Everything in the editor works on a sequence: your own, one from MoClo, or one pasted in.
- On the Trellis home page, click Sequence Editor.
- Choose My sequences in the bar under the title.On the left: what your chair group has saved, with its length, topology and whether it is sequenced. On the right: the MoClo library, any part or plasmid of which can be imported.
- Click pDEMO-L1 35S:tRFP.It opens in the editor: the tools on the left, the sequence in the middle, its features, translations and enzymes on the right.
Other ways in. Open reads GenBank, FASTA, SnapGene (.dna) and plain sequence files; New starts an empty sequence to paste into. Mark a sequence circular if it is: it changes restriction mapping, PCR across the origin and read alignment.
Save first. An unsaved sequence is yours alone and goes when the tab does. Save as… puts it in My sequences, where the rest of Trellis can reach it.
Map and features
See the plasmid whole, then pick out the part you want to work on.
- In the toolbar, under View, click Map.The circular map: every feature on its own ring, restriction sites around the backbone, base numbers inside.
- Click Sequence to go back to the bases.
- Click the blue bar DEMO tRFP (CDS) under the sequence.Its 701 bases are selected. Anything that works on a selection (copy, translate, design primers) now works on the tRFP coding sequence.
Show and hide. Complement, Features and Enzymes in the toolbar switch those layers on and off; Reading frame shows the amino acids in the frame you pick.
Annotate and translate
A sequence with its promoter, CDS and terminator marked explains itself to everyone later.
- Select some bases: click DEMO tRFP (CDS) again, or drag across the sequence.
- Click Add feature.Start and end are filled in from the selection.
- Give it a name, a type (CDS here), the strand and a colour, then Add.It appears on the sequence and in the Features list.
- With the CDS still selected, click Translate.The protein of the selection, 233 amino acids here, with any bases left over that are not a whole codon. Add translation keeps it under the sequence.
- Click Save to keep your changes. History keeps every earlier version.
Faster for a sequence from elsewhere: Auto-annotate marks everything it recognises from the feature libraries in the Features tab. Those libraries read and write ApE's format, and colours follow ApE's GenBank conventions, so files move between the two programs.
Enzymes and a virtual gel
Know what the real gel should look like before you run it.
- Look at the Enzymes panel on the right: every enzyme that cuts the open sequence, how often and where.
- Tick Cutting at most 1 time(s) to keep only single cutters.Or Show non-cutters, which is how you find a site to linearise with. Choose… widens or narrows the set of enzymes considered.
- Under Analysis, click Digest / gel.
- Pick one or more enzymes (hold Ctrl for several) and a ladder, then Run digest.The fragments are drawn beside the ladder you chose; Ladders… adds your lab's own.
Need a site? Silent sites finds where one could be added or removed without changing the protein.
Primers and PCR
Design primers for a region, and check a product before anything is ordered.
- Select the region to amplify: click DEMO tRFP (CDS).
- Click Design primers. Set the target Tm and the length range.Tails are added unchanged to the 5′ end, so a Type IIS site and overhang for MoClo (
GGTCTCA+AATG, say) can be built in. - Click Design.The pair, each with its length, Tm and GC, and the product size. From here: Save to primer stock (Lab Stocks, exactly as designed), Annotate binding sites or Add to notebook.
- Close it and click Simulate PCR. The primers already on the sequence are listed: Use as forward on one, Use as reverse on another, then Amplify.You can also paste any primer, and allow mismatches away from the 3′ end.
Before ordering: Lab primers lists the lab's primers in Lab Stocks that already bind the open sequence, and where. The sequencing primer you need may already be in the freezer.
Cloning simulations
Simulate before you clone: a minute here saves a failed week at the bench.
- Choose Cloning in the bar under the title.
- Pick the method: Gibson / overlap, Restriction + ligation or Recombination (Gateway, Cre-lox). Golden Gate opens in MoClo.
- Add the fragments from the list, in the order they should be joined.The list holds your sequences and the MoClo library. For Gibson, each neighbouring pair must share terminal homology; a fragment is flipped automatically if only its reverse complement overlaps.
- For Gibson, set the minimum overlap (15 bp here) and whether the product is circular, then click Run.Each junction is reported with its overlap and melting temperature. Save the product and annotate it, as in chapter 3.
- For recombination, pick the donor first (the entry clone, or the attB PCR product), then the acceptor (the destination vector, or pDONR), and click Run.Both products of the crossover are listed: in a Gateway LR, the expression clone first, then the by-product carrying ccdB.
Nothing to set for Gateway. Both sequences are read for att sites of the same number, and the shared core is measured on the pair: 15 bp at att1, 19 bp at att2. loxP and FRT share all 34 bp. Set the core length myself is there for anything unusual.
A product of the right size can still be wrong inside. Open it and look at its features. For a recombination, check which product you saved: the by-product is listed too.
No product from a Golden Gate assembly? MoClo gives a per-part report. Usually one part still carries an enzyme site, or two overhangs are the same.
Sequencing reads
A single read cannot tell a real mutation from a bad basecall. Two reads of one clone can.
- Choose Sequencing in the bar under the title, then choose the sequence the reads are of: pDEMO-L1 35S:tRFP.
- Type the colony in Clone number, then click Add reads and choose the files..ab1 chromatograms or FASTA. Every read in that batch gets the clone number. Change it to 2 for the next colony's reads.
- Look at Clone by clone.Reads of one clone are compared with each other: a difference is judged by the reads that actually reach that base. Here the clone is clean where covered, and one read's T to C at 681 is set aside as a bad call.
- Open a read.It is aligned to the sequence with its chromatogram and quality, and every mismatch marked. Tick Only lines with differences to skip the stretches that match, and use Previous and Next to step through the differences.
- Judge the read: Alignment is sufficient or Not sufficient.Say whether it is good enough, and what it says about the clone.
Confirmed, contradicted, only one read. A difference every covering read shows (and at least two do) is the clone's own sequence. One that other reads contradict is a misread. One that rests on a single read still counts, marked, because missing a real mutation is the worse mistake: sequence the other strand.
Calling a base yourself. Click the base in the alignment, look at the trace, press A, C, G, T or N. Nothing is overwritten: Undo my call puts the instrument's letter back.
Changing the sequence to match a read. Correct this one and Correct all to this read save a new version of the sequence.
Confirm a clone
Confirming ties the tube in the freezer to the sequence that proved it.
- When the reads say the clone is right, confirm the sequence and name the clone you confirmed: clone 2.The sequence is marked confirmed, with who confirmed it and from which reads. Its glycerol stock appears in Lab Stocks with the next code, already linked to this plasmid.
- Look at Verification.Confirmed, the clone, who and when; below it every glycerol stock Lab Stocks has for this plasmid, with its strain and where the tube is kept.
- Click Add a stock for another tube.A plasmid is usually kept in more than one strain: the cloning strain and the one it was moved into, E. coli and Agrobacterium, say.
- Choose A new glycerol stock in Lab Stocks, give the strain and where it is kept, then Add the stock.Or choose A glycerol stock that already has a number to link a tube Lab Stocks already numbered. Padding does not matter:
GL-G-00178findsGL-G-0178. - Click a stock's code to open it in Lab Stocks.Fill in the strain and where the tube is, and print its label.
Do it here, not by hand. Confirming makes the stock for you. Entering it separately is how a tube and its sequence come apart.
Nothing is renumbered or replaced. The number recorded at confirmation stays; each stock keeps its own code. A number Lab Stocks has never issued is refused, so add it there first.
Confirmed the wrong clone? Confirm again with the right one. The stock already made can be corrected or marked used up in Lab Stocks.
Bisulfite primers
For DNA methylation: primers that work on DNA after bisulfite has changed every unmethylated C.
- Select the region to amplify in, or nothing for the whole sequence (at most 10 kb), and click Bisulfite primers under Analysis.Here nothing is selected, so all 1,497 bp is searched.
- Choose a converted strand (or either), how many pairs to suggest, and a genome to check against.Bisulfite turns unmethylated C into U, read as T, so afterwards the two strands no longer match. A pair amplifies one converted strand, never both.
- Open More options if you need to.Primer length, how many Y or R bases a primer may have, the longest repeat, the Tm and product ranges, and the ceiling for hairpins and dimers.
- Click Design.Pairs come best first. Each shows its primers with the Y (C or T) and R (G or A) picked out, their Tm and place, and the product after conversion with the converted bases marked.
- Save a pair to Lab Stocks, annotate where it binds, or add it to the notebook.
- When fewer pairs pass than you asked for, read Why only 2 of the 3 asked for.For each strand it counts what every cutoff turned down, names the step where the candidates ran out, and says which option to change.
Why the primers are longer. 25 to 30 nt, because converted DNA is mostly three bases. A primer sits where its strand has few Cs (or, for the bottom strand, few Gs); each one it cannot avoid is written Y or R, so it anneals whether that C was methylated or not.
The genome check. Each primer's site, as it reads before conversion, is searched with BLAST in the Genome Browser. A primer is turned down if it matches elsewhere over more than 90% of its length at more than 90% identity. The first check of a genome waits while it is prepared: seconds for Arabidopsis, longer for a large one.
Credit. The ranking follows design_bisulfite_primers.py v1.1, a later version of v1.0 by Colette L. Picard (06/05/2016). The tool is rewritten from v1.1; the maximum product length is now applied, a reverse primer's hairpin is measured on the primer itself, and a pair's dimer is measured on the real bases.
Into the notebook
Keep the map, the primers or the reads with the day's work, where the lab will look for them.
- Open the sequence you want to record: pDEMO-L1 35S:tRFP.
- Click Notebook in the toolbar.The map of the sequence as it is now, with its features, goes at the end of the day's page.
- Check the Day, then click Add to notebook.If the day is not in your notebook yet, it is started.
- A message confirms where it went: Added to 13-11-2026 Friday in your Lab Notebook.
The same button is elsewhere. Add to notebook is on a designed primer pair, a bisulfite pair and each sequencing read.
From the notebook back. Type @ in a page to link a plasmid; the link opens here, in the editor.