Trellis Tools · Walkthroughs

Walkthroughs › Sequence Editor

Sequence Editor

Map it, clone it in silico, and prove the clone

Follow one plasmid, pDEMO-L1 35S:tRFP, from opening it to confirming the clone that carries it. Every step uses the demo records, so what you see on your screen matches the recordings here.

Versions Recorded on 13 November 2026 with Trellis 2.49.2 and Sequence Editor 0.28.5. Yours are under About in the tool's own header. If yours are newer, a screen here may have moved on; if they are older, something on this page may not be there yet.

Before you start

  1. Have Trellis running: on a lab server, or on your own computer for practice (install).
  2. 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
  3. Sign in as demo, password trellis-demo (or the one set with DEMO_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.

1

Open a sequence

Everything in the editor works on a sequence: your own, one from MoClo, or one pasted in.

  1. On the Trellis home page, click Sequence Editor.
  2. 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.
  3. 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.

Recording · Open a sequence
RecordingFrom the home page to pDEMO-L1 open in the editor.
My sequences
My sequences and the MoClo library side by side.
Editor
The tags under the name: linked to MoClo, sequenced, and its two glycerol stocks.
2

Map and features

See the plasmid whole, then pick out the part you want to work on.

  1. In the toolbar, under View, click Map.The circular map: every feature on its own ring, restriction sites around the backbone, base numbers inside.
  2. Click Sequence to go back to the bases.
  3. 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.

Recording · Map and features
RecordingMap view, then back to the sequence to select the tRFP CDS.
Map
The circular map of pDEMO-L1, 1,497 bp.
Selection
Clicking a feature selects its bases.
3

Annotate and translate

A sequence with its promoter, CDS and terminator marked explains itself to everyone later.

  1. Select some bases: click DEMO tRFP (CDS) again, or drag across the sequence.
  2. Click Add feature.Start and end are filled in from the selection.
  3. 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.
  4. 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.
  5. 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.

Recording · Annotate and translate
RecordingA feature added over the tRFP CDS, then its protein translated.
Add feature
Add feature, filled in from the selection.
Translate
Translate: 233 aa from 701 bp.
4

Enzymes and a virtual gel

Know what the real gel should look like before you run it.

  1. Look at the Enzymes panel on the right: every enzyme that cuts the open sequence, how often and where.
  2. 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.
  3. Under Analysis, click Digest / gel.
  4. 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.

Recording · Digest
RecordingSingle cutters, then a double digest on a virtual gel.
Enzymes
Only the single cutters marked.
Digest / gel
The virtual gel beside a 1 kb ladder.
5

Primers and PCR

Design primers for a region, and check a product before anything is ordered.

  1. Select the region to amplify: click DEMO tRFP (CDS).
  2. 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.
  3. 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.
  4. 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.

Recording · Primers and PCR
RecordingPrimers designed for the tRFP CDS, then a PCR simulated with primers on the map.
Design primers
A pair for the tRFP CDS, product 701 bp.
Simulate PCR
Simulate PCR: a 902 bp product.
6

Cloning simulations

Simulate before you clone: a minute here saves a failed week at the bench.

  1. Choose Cloning in the bar under the title.
  2. Pick the method: Gibson / overlap, Restriction + ligation or Recombination (Gateway, Cre-lox). Golden Gate opens in MoClo.
  3. 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.
  4. 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.
  5. 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.

Gibson / overlap
Gibson / overlap: pick the fragments in order, set the overlap, run.
Recombination
Recombination: donor first, then acceptor. The core is found for you.
7

Sequencing reads

A single read cannot tell a real mutation from a bad basecall. Two reads of one clone can.

  1. Choose Sequencing in the bar under the title, then choose the sequence the reads are of: pDEMO-L1 35S:tRFP.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

Recording · Sequencing reads
RecordingTwo reads of clone 2 added and compared, then a read opened at its one difference.
Clone by clone
Clone by clone: the T to C at 681 is contradicted by the other read.
One read
A read against the reference: 99.9% identity, one mismatch.
Only the differences
Only the line with the difference, the matching stretches folded away.
8

Confirm a clone

Confirming ties the tube in the freezer to the sequence that proved it.

  1. 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.
  2. 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.
  3. 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.
  4. 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-00178 finds GL-G-0178.
  5. 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.

Recording · Confirm a clone
RecordingA clone confirmed, a second glycerol stock added, and the stock opened in Lab Stocks.
Verification
Verification: the clone, and every glycerol stock of the plasmid.
Add a glycerol stock
Add a stock: a new number, or one that already exists.
In Lab Stocks
The stock in Lab Stocks, linked back to the plasmid and its reads.
9

Bisulfite primers

For DNA methylation: primers that work on DNA after bisulfite has changed every unmethylated C.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. Save a pair to Lab Stocks, annotate where it binds, or add it to the notebook.
  6. 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.

Recording · Bisulfite primers
RecordingBisulfite primers designed for the whole plasmid, checked against Arabidopsis.
Bisulfite primers
The options: strand, number of pairs, genome.
Why only 2 of the 3
Why only 2 of the 3 asked for names the step that ran out, and what to change.
How the primers were chosen
What every cutoff turned down, for each converted strand.
10

Into the notebook

Keep the map, the primers or the reads with the day's work, where the lab will look for them.

  1. Open the sequence you want to record: pDEMO-L1 35S:tRFP.
  2. 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.
  3. Check the Day, then click Add to notebook.If the day is not in your notebook yet, it is started.
  4. 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.

Recording · Into the notebook
RecordingThe map added to today's page of the Lab Notebook.
Add to the Lab Notebook
Choose the day; the map goes at the end of its page.
Added
The confirmation, back in the editor.