PlasmidPop user guide All pages Open the app

Viewing and selecting

The toolbar's view switcher shows the Sequence view, the Map, or Both side by side. The two views share one selection: whatever you select in one is highlighted in the other and reported in the status bar as N bp selected, from to to, GC p % (1-based, inclusive). A selection through the origin of a circle ends at a small number (591 to 20 on a 600 bp plasmid), and every panel that names a range writes it the same way.

The switcher, the Complement (Alt+C), Translations (Alt+T) and Cut sites (Alt+R) toggles next to it, the Format menu's choices (the GC track and its window among them), the Edits baseline and the sizes of the panes are remembered in the browser, so the views come back the way you left them the next time you open PlasmidPop. They are settings of the app, not of a document: they do not change with the file you open and are not written into a saved file.

Sizing the panes

In the Both view the boundary between the map and the sequence can be dragged: take hold of the line between them and move it. The same handle sits on the sidebar's inner edge. Each pane has a floor it will not be dragged below, so it is never squeezed to a sliver.

Putting the sidebar away

Clicking the sidebar tab that is already open closes the panel and leaves the tab strip on the window's edge, giving the views the whole width. Clicking any label opens it again on that tab, and Alt+S does both. The panel keeps whatever you had typed into it while it is closed.

Which panel is open belongs to the document tab, not to the window: switching files brings back the panel that file was left on, and a file opened while you are working in one panel opens on the same one. So setting up a digest in Cloning and opening the insert alongside it keeps you in Cloning, and looking at the insert's features does not move the first file.

On a phone

On a screen narrower than about 600 px PlasmidPop is a reader rather than an editor: it shows one pane at a time, chosen from a bar at the foot of the screen. It is meant for the plasmid someone sent you as a link, read where the message arrived.

To open a GenBank file that arrived as a mail attachment, share it to PlasmidPop from the mail app, on Android with PlasmidPop installed: see Opening an attachment from another app.

Nothing about a document is different on a phone: it is the same file, stored in the same browser, and everything comes back on a wider window. A notice says so the first time; Got it puts it away for good. A tablet is wide enough for the normal layout, with the map above the sequence in portrait, and the same touch gestures work there.

Sequence view

Bases are laid out in rows that fill the available width — or a width you fix in the Format menu, below — with a ruler above each row giving the position of its first base. Below each row:

The first and last rows also show the sticky ends of a molecule that has been cut: single-stranded bases are washed over with a gap opposite them, and an overhang on the other strand is drawn just outside the first or last column (see Simulated cloning).

Clicking a feature bar selects that feature; clicking an amino acid on a translation line selects that residue's three bases. The pointer turns into a hand over those tracks and stays a text cursor over the bases, where it places the caret. Lowercase bases stay lowercase, as many people use case to mark regions.

File ▸ Export figure…, with Sequence view chosen, writes what you see as an SVG vector file, a PNG picture or a PDF for figures — the whole sequence, the selection or a range, at a chosen number of bases per row, on A4 or US Letter pages if you like; see Exporting.

GC content

Format ▸ GC content track (Alt+G) adds a track of GC content. In the sequence view it is a band under the strands of each row, with a line for the fraction of G and C in a window centred on each base and a hairline at 50 %. On the map it is a ring just inside the feature lanes, with hairlines at 0 and 50 %; the name in the centre makes room for it. Hover the track for the exact value, the window and the base. It is for DNA and RNA; a protein has none, and the phone's reader leaves it out.

The window is Automatic until you choose one under the toggle (10 to 1,000 bases): 50 bases in the sequence view, and about 1 % of the sequence (at least 10 bases) on the map, where a window as short as the sequence's resolution would be noise. On a circular sequence the window wraps the origin, so the line is continuous across it; at the ends of a linear sequence it is the half window that exists. Ambiguity codes count for what they could be: S is GC, W is not, R, Y, K and M are half, and N says nothing and is left out. Both the track and the window are remembered in this browser. A long sequence (over 200 kb) is worked out in the background, and the track appears when it is ready.

The status bar also gives the GC of whatever is selected, whether or not the track is on: 1,200 bp selected, 101 to 1,300, GC 52.3 %. On a circular sequence a selection across the origin is counted across it.

Previews

Some things are worth seeing on the sequence and the map before they are anything in the document. A previewed span is drawn dashed, in a colour used for nothing else: in the sequence view in a band outside the feature lanes, on the map in a ring just inside the backbone, where a span too short to see is widened as a short selection is.

Nothing previewed is part of the document. It is not saved, it is not in the SVG exports, it costs no undo step, and it goes away when you edit the sequence or close the panel that asked for it. Switching to another sidebar tab takes it off the views too, and coming back brings it back: what the panel was showing is kept for each document while the page is open. Two panels can preview at once — the find bar and a sidebar tab, say — and their spans are drawn together.

A primer's arrow is marked in the colour of a changed base wherever the primer does not pair with the sequence under it, so a mismatch is seen where it is rather than counted in a list.

Today these use it:

Format

The toolbar's Format menu (Alt+O) sets how the sequence view draws. It is laid out as a list of settings: each setting is one row, with its choices side by side on the right, so every choice is in view and one click away. Choices take effect at once and the menu stays open, so you can try one and look. Tab walks the rows and the arrow keys move along a row's choices; Escape closes.

Sequence view — the strands themselves:

Tracks — what is drawn around the strands:

Under a separator, two items that are not about the sequence view:

The SVG exports follow the bases-per-row, numbering (residue numbers included) and colour choices, chosen colours included. They keep their own text size and font so the file looks the same whatever the screen is set to. All of these are remembered in this browser.

Circular map

The map draws the backbone as a ring with tick marks, features as arcs in lanes around it, and labels with leader lines. Features that share a name (a gene and its CDS, for example) get one label, and a gene and CDS of the same name on exactly the same bases are drawn as one bar, the CDS's, in both views; the feature list still lists both. Cut sites of the ticked enzymes are labelled on the same ring, unless Cut sites is off in the toolbar. The centre shows the name and length when they fit whole; on a narrow map the name is set smaller, and past that it is left out rather than squeezed or cut short, since the toolbar has it. Under the name the length reads "5,432 bp circular" or "5,432 bp linear", dropping the topology on a map too narrow for it.

A linear sequence is drawn as an open ring with a wide gap (24 degrees, at any map size) at the top. The sequence is laid out over the rest of the ring, so the features, ruler, selection and clicks all stop at its two ends and nothing is drawn or can be clicked in the gap. Each end has a cap across the backbone and a number: 1 at the left end and the length at the right.

Nothing is too small to see. A feature of a few bases, less than a pixel of ring on a large plasmid, is drawn as a narrow mark at least three pixels wide, and it can be hovered and clicked at that width. A selection that short, and the cursor itself, are drawn as a needle from outside the backbone in through the lanes, so they are not lost under a feature.

Lane widths and fonts do not change with zoom; the tick marks get denser as you zoom in.

When there are more labels than room

Every label — a feature's name, a cut site, one of the ruler's position numbers — is kept clear of every other one. A label that cannot sit beside the thing it names slides along the ring until it finds room, so it stays on the same side of the map and never crosses the circle. It slides a short way only: a name a long leader line away from its own tick is harder to read than no name at all, so past about eight lines' worth the map leaves it out instead of towing it to the end of a crowded arc. A bunch of labels shares out the room around it: the bunch spreads about its middle, so the labels at its edges are not squeezed out by the ones in the middle, and one crowded against the top or bottom of the circle moves away from it together. The labels stay in the order their ticks are, and their leader lines do not cross; where two features sit at nearly the same place one of them has to give way, and it is either drawn with a leader that crosses its neighbour's or left out. A label with no room beside the ring can go a little further out, on a second row or column outside the first, where its leader can reach it without running through another label. The same document is laid out the same way every time it is opened.

Past a certain number of labels the ring is full, and the map leaves some out rather than writing them over each other. It says how many in the bottom-left corner: +7 labels not shown. What is left out is decided by the document, not by where the crowding happens to be: features keep their labels before cut sites do, longer features before shorter ones, and a rare cutter before an enzyme that cuts all over the plasmid.

Nothing is lost by it. Hover a feature arc or a cut site's tick mark and its name appears even if the ring had no room for it, drawn in a rounded outline so that it reads as lying on top of the map rather than as a hole in it. The feature list and the Enzymes tab list everything either way. Zooming in also frees up room, since a label whose feature has gone off screen no longer takes a slot.

The SVG map export does not leave labels out — a figure has nothing to hover. It grows its canvas around the same circle until they all fit instead, so an exported map may be a little wider than it is tall, and it lets a label sit further from its feature than the map on screen would, for the same reason: on paper a name that did not fit is gone for good. A map with hundreds of feature lanes gets a canvas big enough for the whole circle, so it is never exported blank.

Selecting

In the sequence view:

Elsewhere:

Many actions work on the selection: Add feature, Delete selection, Copy and Cut, Export selection, Translate, Design primers, Align against selection.

When you let go of a selection in the sequence view, a small bar appears beside it with the commonest of these: Style ▾ (see Colouring and enlarging bases), Case ▾ (see Typing, deleting, replacing), Add feature and Copy, and how many bases are selected. It sits above the selection, or under its last row, below that row's translations and feature lanes, where there is no room above for the Style menu, so the selected bases stay in view while you work on them. A selection whose first and last rows are both out of view (Ctrl+A on a long sequence, say) keeps the bar at the top of the view as you scroll. While the mouse is elsewhere (a selection made on the map or from a panel) the bar is faded; it comes back in full as soon as the mouse is over the sequence. Clicking a single position, or selecting nothing, puts it away. The phone reader has its own Copy after a long press instead.

The checksum

The right of the status bar shows a short checksum of the open molecule, like cdseguid=dUxN7Y…. Click it to copy the whole thing.

It is a SEGUID v2 name, and it has one property that makes it worth having: it does not change when the molecule is written differently. A plasmid has no first base, and DNA has no top strand, so rotating a circle to another origin or reverse-complementing it gives a file that shares no text with the one you started with — and the same checksum. Two molecules with the same checksum are the same molecule; two with different checksums are not.

Paste it into a lab notebook, an email or a methods section and anyone with the same construct can check they have the same construct — without either of you sending the other the sequence. Compare with… shows both checksums, and uses them to line a rotated plasmid up with this one before showing the differences.