Online herbarium transactions: image based loans
Document prepared July 2012
INTRODUCTION ................................................................................................................................................ 2
SUMMARY OF STEPS ........................................................................................................................................ 2
FOR THE LENDING INSTITUTION ................................................................................................................................... 2
FOR THE RECIPIENT ................................................................................................................................................... 2
INSTRUCTIONS FOR CREATING AN ONLINE LOAN ............................................................................................. 3
YOUR WEBSITE ......................................................................................................................................................... 3
SOME NOTES ON SPECIMEN IMAGES ............................................................................................................................. 3
EMAIL FOR RECEIVING RETURNING DATA ....................................................................................................................... 3
CREATING THE TRANSACTION IN BRAHMS ................................................................................................................... 4
ENTERING THE EMAIL FOR THE LOAN RECIPIENT .............................................................................................................. 4
UPLOADING THE TRANSACTION ................................................................................................................................... 4
DISPATCHING A COVERING EMAIL/LETTER ...................................................................................................................... 6
INSTRUCTIONS FOR ONLINE LOAN RECIPIENTS ................................................................................................. 7
LOGIN TO VIEW AND EDIT THE TRANSACTION .................................................................................................................. 7
IMAGES AND ZOOMIFY .............................................................................................................................................. 9
EDITING DETERMINATIONS AND SAVING CHANGES ........................................................................................................... 9
DETERMINATION RETURN ......................................................................................................................................... 10
Introduction BRAHMS and BRAHMS online (BOL) provide facilities to generate and manage online, image based
loans. This document explains how to create an online loan transaction and how the loan is
processed and then returned by the recipient.
Advantages of image based, online loans include:
Requests for specimens can be processed and dispatched quickly, in some cases instantly.
The physical material remains safely in place. In some cases, herbaria have a policy not to
distribute historic or otherwise rare or fragile material.
The data and images assembled for the loan, if they do not already exist, benefit the lender.
The system encourages and facilitates a return of determinations which can be evaluated
and electronically fed into the senders database.
With no postage costs, faster processing and reduced paperwork, the financial gain can be
significant, especially for larger herbaria.
If you already have a virtual herbarium with specimen images online, in some respects, your
herbarium is already acting as a large online loan service. The online transaction module discussed
here ensures that the material requested is available online, that the correct details are
communicated to the borrower and that some form of arrangement is reached encouraging the
return of determinations – which is normally the principal objective of the lender.
Summary of steps
For the lending institution
Create a normal loan transaction record in BRAHMS for the requested material.
Ensure that the specimens are imaged and that these images are in place on your server.
Use the BRAHMS option to publish the transaction online.
Notify the borrower that the loan is available by sending the transaction URL and ID.
In due course, receive the returned determinations file and incorporate updated names and
related details to the local database as appropriate.
For the recipient
Login to BRAHMS online using the transaction URL received.
Confirm or otherwise edit the names over a period of time using the images and online tools
provided. If preferred, edit an Excel work sheet.
Return the edited data either in stages or when all specimens have been checked and
annotated.
Instructions for creating an online loan
Your website
If you do not already have a BRAHMS online website for your herbarium, this must be created. The
herbarium website you create may be solely to support your online loans service. Alternatively, the
website may be more general in nature and include online loans as one of its functions.
Website creation is discussed in the BRAHMS WebConnect documentation.
Some notes on specimen images
Images are a critical part of the online loans process. Images replace physical specimens in the
transaction and thus it is important that image quality is good, ideally sufficient to make an
identification. There are different views on the minimum image resolution necessary and this value
may vary by taxonomic group. Clearly, the higher the quality of the image, the better. However, as
image file size increases, most image related actions tend to slow up. These may include (depending
in your facilities) initial scanning and the saving and copying of the images online. With very high
resolution images (e.g. 600dpi or more), additional costs may be incurred simply with file storage and
maintenance, especially if large numbers of images are being stored. The actual viewing of images
online is not necessarily slower with larger file size as BRAHMS online deploys Zoomify to facilitate
efficient image zooming.
In practice, the imaging of herbarium specimens is a trade-off between image quality, time, cost and
the reasons for imaging.
Email for receiving returning data
Before processing any online transactions, an email address must be entered in your overall BRAHMS
configuration to receive the return of details (names and annotations) concerning the material in
question. This will be normally be the email address of the herbarium curator or loans manager.
Select Admin > Project configuration > Transactions > Email for online loan returns.
Creating the transaction in BRAHMS
Before placing data/images for the requested material online, a transaction record must be created
in BRAHMS in the normal way. This process is described in the BRAHMS manual section on
Herbarium transactions. In brief:
A transaction record is entered using Herbaria > Transactions file.
This will include a link to the recipient whose address should already be entered in your
herbarium list (Herbaria > Herbarium list).
The selected specimens, ideally will one or more image links within BRAHMS, are then linked
to the transaction record using one of several methods. If the data for the requested
specimens have been newly added to an RDE file, the records can be auto-linked on
transferring the RDE file to BRAHMS. If the records are already in BRAHMS, you can manually
link specimens one by one or alternatively, extract the specimens (e.g. everything in a genus)
and then auto-link tagged specimen records in the specimen extract file to the transaction
using the Tools option provided.
Entering the email for the loan recipient
When entering the transaction record, you must include the email of the loan recipient. This will be
used to identify the recipient when they login to the BRAHMS online service.
Uploading the transaction
The equivalent to physically sending the loan by post is publishing the transaction on your website.
When you do this, the data and images for this loan are published online but only available and
visible as a transaction to the recipient.
The images linked to the relevant specimens in BRAHMS must be separately copied to the correct
folder on your server otherwise they will not be visible. Notes on image folders are provided in the
WebConnect guide.
Here are the steps:
Select PublishOnline > Upload or remove data from the selected server and log in using
your online credentials.
Choose the Herbarium transaction option and select the transaction number to upload and
then Create XML and upload to server.
What happens when you upload a transaction:
The specimens linked to the transaction are uploaded to your server - even if these
specimens have already been uploaded. This ensures the transaction specimens are online
and up to date.
Image data (links between images and specimens, keywords, copyright notes, captions if
provided) for these specimens are uploaded as available. As mentioned above, the actual
image files must be copied as a separate process to the correct images folder on your server.
The transaction details (ID, date, address, etc). are uploaded.
Finally, an online transaction URL is generated and added to the transaction record in
BRAHMS. The transaction URL is discussed further below.
The status of the upload can be monitored on the Upload history tab.
When you generate an online transaction, a transaction URL is added to the transaction record.
The transaction URL, auto-generated when you post the transaction online, is added to the relevant
transaction record in BRAHMS (Herbaria > Transactions file). This URL is a direct website link to the
transaction. It requires a login to open.
Dispatching a covering email/letter
Your next task is to send the all-important transaction URL to the borrowing institution with an
appropriate covering note explaining that the material requested is available online.
It will be advisable to include a standard attachment with a simple description of online editing
procedures as explained in the next section together with the usual persuasive blurb encouraging a
speedy return of determinations.
Instructions for online loan recipients
Login to view and edit the transaction
When the user goes to the transaction URL on the BRAHMS website, he/she will be asked to log in.
The login provides full editing access to the transaction. Nobody else can see the transaction.
The login name will be their email. If the login password has been forgotten or the recipient is not
registered on the BRAHMS website, they can easily retrieve the password or register.
After login, they will be taken by default to the Transaction data grid which lists the relevant
specimens.
The default transaction view in Grid view mode. And below, viewed in Report mode.
The material can also be viewed using any of the other active menu options in grid or report mode.
In Report mode, data and images can be viewed on a single page.
To view all images together, select the Images menu
The images tab displays all images for this transaction, sorted by taxa.
Images and Zoomify
Images can be viewed specimen by specimen on the transaction menu (grid or reports) or collectively
from the Images menu. In either case, images are displayed in Zoomify and the user can explore each
image to the maximum detail provided.
Together with the data provided (or read from images of labels), the recipient can decide on the
identification of the specimens
Editing determinations and saving changes
The toolbar shown above in the red circle opens the determination editing form. The form is used to
edit specimen determinations as required. The form provides the options:
Existing det. is confirmed Existing det. is incorrect (det. Unknown) Existing det. is incorrect (new det. doubtful) Existing det. is incorrect (new det. Is certain)
The determination editing form. If options 3 or 4 are selected, the species editing options are enabled as shown
here.
The recipient can apply the current decision to a single specimen or all tagged specimens.
Any edits to the names or the determination status are saved securely on the server when the Apply
det or Apply to tagged option is selected. Inevitably, editing may continue for several weeks or
months and these changes are always saved.
Determination categories are colour coded.
Determination return
The revised determinations / confirmations can be returned in part (as with a physical loan) or when
all the material has been identified. To return the edited file (confirmations/determinations), the
Return my dets option is used. This generate a text file and an excel file to send back to the lender –
with the updated dets and any other annotations.
Determinations/ confirmations can be returned at any time, either a partial list or the complete loan. A colour
coded list of dets is created as show below, together with an Excel attachment. These data are sent to the
email set up for receiving returned determinations as described earlier in this document.