[[PageOutline]] = MeLuDI 1.5.0 User Manual = == 1 Introduction == Welcome to MeLuDI, a [http://base.thep.lu.se BASE] extension package with registration wizards for melanoma-lung cancer projects. === 1.1 What's in this manual === This manual is intended to be helpful for the daily user of MeLuDI. Sections marked with an asterisk (`*`) are not absolutely essential to using the software, and can be skipped, if an answer to a specific question is desired. However, the reason for including these sections at all, is that they may add to the total understanding of the context in which MeLuDI works and was developed. === 1.2 *Background (for history buffs) === ==== 1.2.1 BASE ==== [http://base.thep.lu.se BASE] was developed as a free web-based database LIMS solution for tracking of information and data generated in sequencing and microarray experiments from sample to analysis. ==== 1.2.2 Reggie ==== BASE extension package [http://baseplugins.thep.lu.se/wiki/net.sf.basedb.reggie Reggie] was developed as an interface to BASE, tailored to the laboratory workflow for the [http://scan.bmc.lu.se/index.php/Main_Page SCAN-B] breast cancer project (more accurately, to the part known as SCAN-B Primary). Reggie both simplifies entry of LIMS data into BASE, as well as inspection of the data and production of documents such as dilution protocols and results reports. At the time of writing, Reggie provides help with management of the complete pipeline from incoming samples, through extraction, library preparation, pooling for sequencing, secondary analysis of the NGS sequencing output, report generation and digital distribution. ==== 1.2.3 MeLuDI mid-2014 - mid-2016 ==== [http://baseplugins.thep.lu.se/wiki/net.sf.basedb.meludi MeLuDI] was later developed as another BASE extension, based on Reggie, but intended for melanoma-lung cancer projects. It was named "MeLuDI" after the original project it was developed for, which got its name from "melanoma/lung cancer diagnostics". (When the name "MeLuDI" is used in this document without further specification, the reference is to the software.) MeLuDI was developed continuously until version 1.4.3, when the original MeLuDI project was terminated. The software then covered a workflow from sample registration to library preparation. ==== 1.2.4 MeLuDI fall-2016 - ==== During fall 2016, a number of research projects at Lund University involved lab work using a workflow very close to the one used for the original MeLuDI project, so it was decided that a modified version of the MeLuDI software was to be used to track samples. MeLuDI was updated to support use in several BASE projects, allowing different items to have project-specific prefixes and number of digits in names, as well as project-specific default values for a number of items. Created documents like dilution protocols and statistics reports were updated to include the name of the active project. Together with other updates intended to support more flexibility in the workflow, the updated software was released as MeLuDI v1.5.0. === 1.3 *Motivation for use === ==== 1.3.1 Why use a database to store LIMS info in? ==== The excellent search abilities of a database, especially a relational database, is normally enough to justify its use. ==== 1.3.2 Why use BASE? ==== If you work with a genomics project, BASE provides a convenient interface to the underlying database: a. Listings of items like samples, extracts, bioplates, etc. can be easily selected from menus, and filters and sorting rules can be entered in a simple way. b. BASE is built with a knowledge of the relationship between the different items, e.g. an extract item can be created from the page describing the parent sample/extract, and the created extract will automatically be linked to the parent item, and the new child item will appear on the page for the latter. c. BASE contains tools to simplify import/export of data in batch-mode, e.g. batch import can be made from definitions in a text file with tabular data in tab-separated columns. d. Project and user management. BASE allows data to be coupled to a project item, and the system normally only shows items for that project, but items can also be shared to several projects. User administration is also included, where a user can be given different sets of permissions in different projects. e. Support for two-factor authentication for increased security. f. Web-based interface. When BASE was first conceived, not all database management systems had web-based interfaces. The decision whether to use BASE or not, often depends on the prevalent digital infra-structure for the laboratory. Much of the work in creating a new BASE installation is related to setting up the server and installing the database, that BASE will use. If a BASE installation already is present in the laboratory, much is simplified. However, the final decision may also depend on other conditions, e.g. requirements to use another LIMS system by regulations or policy decisions. ==== 1.3.3 Why use MeLuDI? ==== Although genomics data can be entered directly in BASE, if you are working in a project with a workflow similar to that covered by MeLuDI, its use will simplify several things: a. Creation of multiple extract items from the same parent sample/extract item in BASE requires performing the same operation repeated times. MeLuDI allows all necessary data to be entered in a wizard, after which it creates the new items with needed database links and attached information. b. MeLuDI provides support for naming conventions for different items in a project, something BASE is ignorant of. Specific prefixes and number of digits in serial numbers may be chosen for items such as samples, item lists, storage boxes, library plates, patient items, and library preparation kits. This is also supported by the system proposing serial numbers in names for new items, as well as storage box positions. c. MeLuDI uses a suffix system for names of child items inherited from Reggie, where specimens have a dot plus a number added to the case name, DNA extracts have ".d" added to the parent name, FPA aliquots have ".fpa" added to the parent DNA name, etc. This allows the parent heritage items to be identified for an extract directly from the name. d. Support exists for creating input configuration files with selected sample names for various instruments, as well as importing measurement values from text files generated by the instruments. Files can also be created for label printers. e. MeLuDI allows creation of dilution protocols, plate layouts, and statistical reports in formats, that are suited both for inspection on a screen and for print-outs. f. Information related to the same case can be conveniently displayed in a summary page, with links to the individual BASE items, for further inspection in BASE. ==== 1.3.4 Miscellaneous ==== [[Image(snake-icon-64.png)]][[Image(spacer_1_0.png)]][[Image(dancing_reggie.gif)]] Figure 1.1. Reggie the snake, mascot of both the Reggie and MeLuDI BASE extensions. A smaller version of the left image is used as menu icon for Reggie ([[Image(snake-icon.png)]]), while a musical note is used for MeLuDI ([[Image(musical_note.png)]]). ''Note to non-Swedish readers'': As you might have suspected, various musical references in connection with MeLuDI is caused by it being very close to "''melodi''", the Swedish word for "melody". == 2 General interface structure == MeLuDI inherited a general interface structure from Reggie. The interface was created with the intention of making access to central functionality as simple as possible. === 2.1 Start (index) page and some key components === [[Image(MeLuDI_001_index_page_SMIL_01_with_key_elements_numbered_80_pct.png)]] Figure 2.1. MeLuDI start (index page) ==== 2.1.1 MeLuDI start (index) page key elements ==== 1. BASE main menu bar (Note! Not to be confused with the web browser menu bar at the top). 2. BASE project menu (the image shows project "SMIL" as active project). 3. BASE Extensions menu. This is the menu where extension "MeLuDI" is selected. 4. Name of active project, here: "SMIL". (MeLuDI only) 5. BASE extension name; also works as quick link to the start (index) page, i.e. the page above. 6. Link to a MeLuDI web page, e.g. a wizard. 7. A counter, showing the number of items in queue (optionally) for a wizard. ==== 2.1.2 User permissions and shown sections on the start (index) page ==== The example start page above shows five sections: a. Sample processing wizards b. Library preparation wizards c. Server administrator wizards d. Personal information wizards e. Statistics and reporting wizards The number of shown sections on the start page depends on the permissions of the logged-in user, as only sections the user is allowed to use are shown. The example above shows all sections, as the logged-in user is `root`, i.e. system administrator. The "Server administrator wizards" section is only visible for a system administrator, and the "Personal information wizards" section is only visible for a system administrator and users belonging to the `PatientCurator` group. === 2.2 Wizard page and some key components === ==== 2.2.1 Wizard page example and key elements ==== [[Image(MeLuDI_002_specimen_tube_registration_page_SMIL_steps_01-02_01_80_pct.png)]] Figure 2.2. Specimen tube registration wizard steps 1-2 ==== 2.2.2 Wizard steps ==== [[Image()]] ==== 2.2.3 Cancel and Next buttons ==== [[Image()]] ==== 2.2.4 Cancel and Registration buttons ==== [[Image()]] ==== 2.2.5 Registration messages and Restart button ==== [[Image()]] [[Image()]] [[Image()]] Below is a description of some of the key elements, that are components of most of the wizards. ==== 2.2.3 User permissions and wizards and results pages ====