Where sample management meets electronic lab notebook



Current Articles | RSS Feed

The 4 most requested features in the electronic lab notebook eCAT

Posted by Rory on December 6th, 2010 @ 9:14 am

Usually I write about what’s in eCAT and what you can do with eCAT.  Today I’m going to highlight things that are not — yet — in eCAT.  Here are the four most requested features.

Export to PDF

More convenient export of records is important for a couple of reasons.  First, you may want to save a copy of a record, or multiple records, in a form that is easy to reproduce and/or show to others.  Second, easier export of records provides a feeling of security that you can always get your data out of eCAT.

PDF import

Scientists make extensive use of PDFs, so it’s not surprising that the ability to import PDFs into eCAT is a frequently requested feature.

Import as a database

eCAT’s ability to import spreadsheets as spreadsheets is very popular.  But it would also be useful lto be able to import data from a spreadsheet in tabular form, i.e. using a CSV importer.

Image annotation

A large percentage of researchers in biology and medicine make extensive use of images in their research.  The ability to annotate those images is essential to them, so they need this feature in an electronic lab notebook.

A short post this time but hopefully a useful one.  Thanks for the feedback!  All four of these features will be in the spring 2011 release.

Tips on screen grabbing scientific images for an electronic lab notebook

Posted by Rory on October 25th, 2010 @ 10:09 am

Most of the images you’ll want to attach to an electronic lab notebook like eCAT  you’ll already have as an image.  Sometimes, however, you’ll want an image of something you can see on your screen, but which isn’t actually an image. A common of example of this is a chart shown in Excel or OpenOffice. It looks like an image, but you can’t export it from Excel as an image. What to do?

There are a variety of things you can do to turn something you see on the screen into an image for upload to an electronic lab notebook like eCAT:

An image on a web page

Right-click on the image (Ctrl-click on Mac), and select “Save image as”.

An image in another application that can export images

Lots of applications that deal with images of one form or another can export them as a standard format such as PNG, JPG or TIFF. Once exported, the image can then be uploaded to eCAT. TIFF is often preferable for scientific images as it can include metadata.

Spreadsheets

Excel does not allow export of charts as images. However, you can add a capability to your copy of Excel which will allow you to export a chart as an image. This is fully described on this web page.

OpenOffice Calc does not allow export of charts as images. However, you can copy the chart and paste it into OpenOffice Draw, which does allow export as an image. Select the chart so it has green handles, copy and paste into Draw, then in Draw while still selected do File | Export.

An arbitrary area of your screen

Sometimes you’d like an image of part of your screen – for example a portion of an image, or a portion of a web page. Different operating systems provide different functionality and applications for this – here are some options:

  • Windows/Vista. Use the PrintScreen button on your keyboard (usually towards the top and right and labelled PrtScr). This will put an image in the Clipboard of what is on your screen. You can then paste this into another program.Or you can use the popular free IrfanView application, downloadable from here . Options | Capture/Screenshot lets you capture the whole screen or a specific window, and then edit it. To select a portion of the image, just click in the window and drag your mouse. Then use Edit | Crop selection to reduce the image to the portion you selected, and finish by saving the image.
  • MacOS. Use the Grab utility, which is located in Applications>Utilities. With the Capture menu, you can choose to capture a specific area of the screen, a specific window, or the whole screen (use Timed Screen). When you save the file, it will be saved as a TIFF image.
  • Linux. Most Linux variants include a screen grab utility, usually under the Applications menu, which will save the screen or a window as an image. To cut out a specific portion of the screen image, the GIMP image editor can be used. Select Tools | Transform Tools | Crop, drag the mouse over the region you want to keep, and press Enter. The image will be cropped and you can save it.

Further ideas on screen grabbing are here .

Once you’ve grabbed your screenshots, you can insert them into a record in eCAT or import them from the dashboard or as a child record.

How to import images from the dashboard and as a child record in an electronic lab notebook

Posted by Rory on October 18th, 2010 @ 10:18 am

Last week I looked at how to insert images into a record in the electronic lab notebook  eCAT.  This week I’ll look at two other ways of importing images into eCAT, from the dashboard and from the record page.

Importing images from the dashboard

To start, just click on the Import menu item and then on Image

You will be taken to the import page, which looks like this:

The import page

You can choose to import images from your local computer by uploading them to the server, or you can import from an attachment store that your administrator has defined for you.

Importing from your local computer

To import from a local file, click “Choose File” or “Browse” (the exact text depends on your browser) and then select the file you want to upload. eCAT supports a variety of image types. The standard common images types are all fully supported – JPEG, BMP, PNG, GIF etc. We also support a range of specific scientific types such as TIFF, Zeiss LSM, Zeiss ZVI, Delatvision, Biorad (.pic) and Metamorph (.stk).

Importing from the local computer

If you wish to remove a file you have selected for upload, then click the red cross beside the file name.

Importing from an attachment store

To import from an attachment store, click the “Import files from attachment stores” button. Then click in a text box that says “Click here to select an attachment”. The following screen will appear.Importing from an attachment store

Select a file to import from the attachment store, and then click “Insert” to add it to list of files to import. You can import more than one file from attachment stores at once by clicking the [+] button to the right of the text box saying “Click here to select an attachment”.

When you have image files selected from either the local computer or an attachment store, click “Import” to import the files. Some image types support a preview and allow selection of the size of thumbnail images you will see in your imported records. If the image type you are importing works this way then you will see a screen similar to the following:

Previewing an imported image

When you have finished selecting the image sizes, click “Save” to save your settings. You will be taken to the target record if you are importing more than one image, or to the record that you have imported if you have imported a single image.

Importing images as children of a record

When you are viewing a record, you can click the “Import” option in the Children section of the main menu on the left hand side.

This will import the image as a child record of the record currently being viewed.

How to upload images to an electronic lab notebook

Posted by Rory on October 12th, 2010 @ 12:48 pm

The thing you’ll probably want to do  most often with images is insert them into a record you’re working on.    For example, here’s what one  user of the electronic lab notebook eCAT wants to do in eCAT — no doubt representative of lots of users:

“Every day, I take a few pictures, so I want to upload the images directly into my[eCAT] field journal.  I want it to have a paragraph of writing, then a few pictures for that day, then another paragraph, then more pictures, etc.  When I’m finished, I want to be able to print out my field journal with the pictures at the appropriate places, all as one document.”

So how do you get images into eCAT to do that?

1.  Images from the web

To insert an image from the web into an eCAT record, you go to the record, click edit, and then click on the ‘insert image’ icon in the eCAT record editor, which looks like this

The following box will popup:

To find the url of the image on the web, right click on the image, select ‘copy image location’, paste that into the ‘image url’ field in the popup box, and select ‘insert image’.  The image will be inserted into the eCAT record you are editing.

2.  Images from your files

If you want to insert an image from one of your files into an eCAT record, just go to the record you want to insert the image into, click edit, and then click in the location you want to insert the image.  Then click on the following button in the eCAT editor to find the file you want to insert:

The following box will popup:

Next, select an attachment store and a file, and click insert.  A link to the image file will be created at the location in the record you indicated, and when you save the edit you have made, a thumbnail of the image will appear at that location.

3.  Getting images into your files and ready for insertion into eCAT

If you want to insert an image from your files into eCAT, you first want to make sure it’s there in your files in a way that eCAT can see!  Here’s a quick primer on ways of getting images into your files.

Personal and Team Hosted versions

If you’re using a Personal or Team Hosted eCAT it’s  easy to get an image file into a place eCAT can see.  Take a look at this page, http://myecat.axiope.com/help.html?page=DesktopStore_Windows, and when you have your folder set up, just drop the files you want to work with in eCAT into the folder.

Install version

If you’re using an Install version, your IT or the person who runs your eCAT server should have already set up ‘attachment stores’.  These are places where you can put  image files that eCAT can see.

Your image files are now visible to eCAT.  To insert them into an eCAT record just follow the simple steps set out in Section 2 above.

Permissions and sharing in the electronic lab notebook eCAT II: simple permissions for individual eCAT users

Posted by Rory on August 19th, 2010 @ 7:00 am

As noted in the last post, the underlying principle of eCAT’s permissions system is that all records inherit the permissions their parent record has, unless the permissions on the record are reset.  With that in mind, let’s see what happens when a new user creates their first record in eCAT from the eCAT dashboard. You can do that in one of three ways:  by creating a new record, by importing a document, spreadsheet or image, or by creating a record from one of eCAT”s preexisting templates.  In all three cases, the new record will by default be created in your personal ‘user’ folder.  For example, when a new user called Sarah creates her first record, Experiment 1, it is automatically saved in her sarah folder, as shown below.

Like all records, the Experiment 1 record inherits its permissions by default from its parent record, which is the sarah folder. Like all user folders, by default’ sarah’ has all six permissions available in eCAT.  As noted in the previous post, these are:  view, append, edit,  delete, download, and sharing.   So, Experiment 1 has these permissions too, and Sarah can view the Experiment 1 record, edit it, delete it, etc.  Sarah doesn’t need to do anything to make this possible, it just happens automatically in eCAT.

But Sarah has more control that that — she can also change the permissions on Experiment 1 (and of course on other records she creates).  To do that she clicks on ‘sharing’ in the menu at the left of the screen and the following page appears:

By clicking the boxes in Step 1 she can give other eCAT users the ability to view Experiment 1, to edit it, to delete it or to set permissions for it.  And, using Step 2, she can decide which users have these permissions.  Its completely flexible, and well suited to actual lab practices.  For example, Sarah might decide to give view only permission to most members of the lab, and edit permission to another lab member she is working with on Experiment 1 and to the PI, so that the PI can make comments in Experiment 1.  And Sarah has this flexibility for all the records she creates.  If she does nothing they remain private.  But if she wants she can share a record, again in whatever way she wants.

In the next post I’m going to cover sharing and permissions for groups, and give an example of how a lab testing eCAT can set up a Project that multiple members of the lab can work on.

Getting started with the electronic lab notebook eCAT — it’s easy!

Posted by Rory on August 5th, 2010 @ 7:00 am

What’s the best way to get started with eCAT?

The two simplest things to do are (a) import some of your existing data, and (b) create new data in eCAT.  You can do both of these from eCAT’s dashboard, which looks like this:

To import existing data —  a word document, a spreadsheet, or an image — click ‘Import’ and choose what you would like to import, say a word document.  You will be given the option of browsing documents  stored on your computer, so just choose the document you want to select, and then click ‘import’.  The document you have selected is created in your personal space.  To view it simply click on the record with the name of the document and the document will appear, with the correct formatting, just as in the original word document.  You can then continue editing the document in eCAT.

Importing existing data is also covered in the following video

Importing documents, spreadsheets and images

Another way to get started is to create new data in eCAT.  That’s just as easy as importing data!  Again you start at the dashboard, and this time click ‘Create New’.  You will be given a list of types of record that come pre-loaded in eCAT, such as experiment, project, antibody, etc.  Just choose one — for example freezer — and a blank version of the record will appear

You can now begin to edit the record!

For more ideas on how to get started with eCAT, please take a look at the Getting started with eCAT video.

Using the electronic lab notebook eCAT as a replacement for a paper lab notebook

Posted by Rory on July 26th, 2010 @ 7:00 am

Wikipedia defines electronic lab notebook as “a software program designed to replace paper lab notebooks“.  So how can you use eCAT to replace something that looks like this?

Let’s look at this question first from the individual’s point of view and then from the lab’s point of view.  Here’s what Andreas Johansson of Lund University in Sweden says:

“I use eCAT for everything in the laboratory when I need to make a note of anything.  I use it for my experiments and my protocols.  But I also use it for things I didn’t use it for before I had an electronic lab notebook.  I use it for digital photos, so protein gels, screenshots of my HPC runs, screenshots of the small things I see during my experiment.  Before I would have just made a small note about it, now I have a photo of it.  And I also add time stamps during an experiment so I can easily see at what point I did a certain thing.

The main result is very very large quality improvements.  It also brings structure to your experiments automatically.  Since you are working with project folders you have your own experiments, and you also add protocols, and you add the data and you add whatever electronic stuff you get during the experiments to that folder.  So everything gets sorted by date and time.

And here’s what Alex Swarbrick at the Garvan Institute in Sydney, Australia says about his lab’s use of eCAT:

Everyone uses it as an electronic notebook, so they can compile the diverse collections of data that we generate as biologists, such as images and spreadsheets. We use to it to take minutes of meetings. We also use it to manage our common stocks of antibodies, plasmids and so on. Finally, perhaps the most important feature for us is the ability to link records, reagents and experiments. This allows us, for example, to connect an experimental mouse with the tube containing its tissues in the freezer, to the 6 different experiments (conducted over a year) that analysed those tissues in different ways. Managing this kind of ‘metadata’ is absolutely essential to our work, and very difficult to do without tools like eCAT.”

Of the many benefits of using eCAT as an electronic lab notebook noted by Andreas and Alex, three are worth highlighting:

  1. eCAT serves as  a ‘paper lab notebook plus’ because you can use it to record not only garden variety experimental data but also things like images and spreadsheets which can’t conveniently be entered into a paper lab notebook.
  2. eCAT allows you to manage other kinds of information such as notes from meetings, protocols and inventory, as well as experimental data, in a single, integrated environment.
  3. Unlike a paper lab notebook, which by definition is a tool for individuals, eCAT is a group tool that allows controlled  sharing of data.