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.
Today's page
Write on the day, not at the end of the week: one press opens today's page.
- On the Trellis home page, click Lab Notebook.On the left: your notebook, days filed under months and years, newest first; your favourite protocols; and Deleted, where nothing is ever really lost.
- Press Today.Today's page opens, named for the date and filed under its month and year, which are made for you. Pressing it again later opens the same page.
- Look at the top of the page.A booking for today, from Booking, is shown there with a box for what was done, so the page knows which machine you were on. The demo has a PCR machine booked.
- Click in the page and write what you are doing.The page saves itself a second after you stop typing; the header says when it was last saved.
One page, one piece of work. Keep the day page for the day. For an experiment that runs over several days, make a page of its own with + next to a page in the tree, and link to it from each day.
Select text to format it. A bar appears with bold, italic, colours, a highlighter, headings and lists. Start a line with - for a bulleted list.
Link with @
Link, don't retype: a link stays right when things are renamed, and the other record points back.
- On today's page, type
@where the link should go.A chooser opens: a plasmid, a seed lot, plant or line, a stock (primer, chemical, antibody or plant material), a genome track, or a page or protocol. - Choose A plasmid.
- Type a few letters,
pDEMO-L1, and click it in the list.The link sits in the text as a chip with its icon. Clicking it opens the plasmid in the Sequence Editor.
Links work both ways. A stock or seed lot you link lists this page under Mentioned in. That is how a tube in the freezer shows what was done with it.
Just a plain @? Press Just type @ in the chooser.
Whole records, not just links: the Plasmid…, Stock… and Seed… buttons under the page add a card for the record, and MoClo reaction… brings in a reaction from MoClo with its parts and volumes as a table.
A table that scales
Put numbers in a table, not a sentence: it does the arithmetic and can be read later.
- Under the page, next to Add:, click ▦ Table.A new table is ready for a reaction mix: Component, Per reaction (µL), a Total that is a formula,
=B*N, and an Added column to tick. - Give the table a name, then fill in one reaction: each component and its volume.+ Row adds a row.
- Type the number of reactions in Reactions, at the top of the table:
26.Every Total is multiplied by it: 10 µL of master mix becomes 260 µL. - Tick Added as each component goes in.The tick keeps who ticked it and when.
Columns of your own. ⚙ Columns sets what each column is: text, a number, a formula, scaled by reactions, filled in on the day, or a tick box. Formulas start with =: =B*C for the same row, A1:A5 for a range, and SUM, AVERAGE, ROUND and IF work.
From a spreadsheet. A table copied from Excel, Google Sheets, LibreOffice or Word pastes straight in, keeping its rows and columns.
The week's to-do list
One list for the week, shown under every day of it: added on Tuesday, still there on Thursday.
- On today's page, click + Week's to-do.The list for this week, Monday to Sunday, is made and opens. Anything moved on from last week is already on it. On a week that has one, the button opens it.
- Click + Task and type a task.Enter starts the next one; Backspace in an empty one removes it. Type
@to tag a plasmid, stock or seed lot, as anywhere else. - Tick a task when it is done.The tick says who and when.
- Click → Next week on a task that will not get done this week.It stays on this week's list, greyed out and marked as moved, and appears on next week's list saying where it came from. Bring back undoes it.
Who can change it? Whoever can change the day page can change its week's list; anyone who can only read it sees it as it is.
Use a protocol
One shared copy of each method; each day keeps the version it used.
- Under Favourite protocols on the left, click Floral dip transformation (Arabidopsis).The Protocols library is shared by the lab. All protocols → lists the rest; ★ Favourite keeps one on the left.
- Click + Add to page….It asks where to put the protocol: Add to today first, or search for any page or day of yours.
- Choose Add to today.The protocol becomes a page of its own under today's page, named for the protocol and saying which version it came from.
- Tick the steps as you work.Each tick keeps who and when. What you write stays in your copy; the library's protocol is untouched.
Improving a protocol does not change the days that already used it: they keep the version they were done with. The protocol lists every page it was used on under Used on.
Already on a day page? Protocol… under the page puts a copy into the page itself.
Find it again
Search and labels find a piece of work whatever day it is filed under.
- Type in the search box at the top left:
T2, then Enter.It searches the titles and the whole text of every page you may read, protocols included, and shows where each one is filed. - Click T2 drought trial: results.Its seed lots and plants are links into the Seed Bank: the demo's T2 trial, and the homozygous line it found.
- Click + label, give a name and a value,
projectanddrought, then Add.The page now carries#project=drought. - Search for
#project=drought.Every page with that label is found, whichever day it is filed under. Days, months and years carry their date as a label already.
A page in the wrong place? Drag it in the tree. A page can also sit in two places at once without being copied.
Where next
- The Sequence Editor walkthrough follows the plasmid you linked here, from its map to the confirmed clone.
- The notebook's own Help page (Help, top right in the notebook) covers steps, gel photos, attachments and fixing mistakes.