2. Using nmrshiftdb2

The main functions of nmrshiftdb2 (search, predict, submit, review) can be accessed via the tabs on top of the main page.

2.1. Registration (optional)

Registration is necessary if you wish to contribute to the database; it is not necessary if you just want to use the Search and Predict functions. To register, simply click the "Create new account" button, fill in the form, click the "Do you want to become a contributor?" field as appropriate and submit the form. After successful registration you will receive an Email which provides a link which you must visit for confirmation. You can then officially log in to nmrshiftdb2. When logging-in, you can choose to save your user data in a cookie. This means you will be automatically logged-in when you visit this server in the future. The cookie will be deleted when you explicitly log-out; just closing the browser will keep the cookie. Note that this is inherently insecure when other people use your computer with your identity. Only use this when you are sure that you have a secure login on your computer.

nmrshiftdb2 will keep your personal data secret. There are the following exceptions:

nmrshiftdb2 servers log the queries entered by users. These queries are not published and will not be available to anybody except the Administrator. Statistics showing the distribution of queries to query types are compiled and may be published, but they do not contain any individual queries. Logging data may also be used for research purposes, but only results of this research will be published.

Note that the privacy policy given here only applies to the server(s) reached via the www.nmrshiftdb.org URL (the nmrshiftdb2 data project). The software developers can not give any guarantee that other sites running the nmrshiftdb2 software (which is open source) comply with this policy.

If you are interested in becoming a reviewer for new submissions, please send an Email to the administrator.

For registered and logged-in users the individual Search History and the Structures History will be saved after each session and reloaded automatically at the next login. Registered users also see a link "Show all my contributions" on the search page. This displays all contributions plus their status and the assigned reviewers.

We also offer the possibility to registered users to download a list of their latest contributions for inclusion in their homepage. A link like http://www.nmrshiftdb.org/NmrshiftdbServlet?username=name&nmrshiftdbaction=exportlastinputs&numbertoexport=5 will give an html fragment (not complete page). Here username is your username and numbertoexport determines the number of structures (optional, default is 4).

2.2. Using encryption

By using the "Login with SSL" link on top of the page you can always switch to encrypted communications. Encryption is RC4 128 Bit. We do not have certificates from a trusted CA, but our own ones.

2.3. Performing a Search in nmrshiftdb2

The Search user interface is started by clicking the "Search" button near the top of the nmrshiftdb2 window. This action opens the Search pane. The default pane only contains the most important search options; if you want more and more complicated options, choose one the "Switch to expert search mode" links.

There are a variety of search algorithms described below that allow the user to search for database records on the basis of a list of chemical shifts, chemical name, molecular weight, molecular structures, or other text descriptors (properties) and keywords.

Since nmrshiftdb2 contains both measured and theoretically calculated spectra, check box options are provided to specify whether subsequent searches should consider only measured, only calculated, or both types of NMR data.

2.3.1. Search for Chemical Shifts (Spectrum Search)

A Spectrum Search, i.e., the search for a given set of chemical shifts defined by an input list, can be done in two different ways. The shifts must be entered in "Input Field" (one resonance per line). The format is like this:

shift (ppm)
shift (ppm); intensity (a.u.)
(intensity is optional)



The search types are:

  • Subspectrum Search (match all Input as subset of Record): a similarity search which looks for spectra in the database for which a subset of the total NS resonances exhibit chemical shifts equal to or close to the NI values defined in your input list. Matched spectra must contain the same or a larger number of resonances compared to the input list, i.e., the input spectrum can be a subspectrum (NI<=NS). For each spectrum found a similarity factor is calculated, which is a measure of how closely your input data are matched by the relevant chemical shifts in the database spectrum. A Hitlist of spectra is returned, in the order of decreasing similarity. The similarity measure is 100% if all NI peaks in the input list can be exactly matched by a subset of peaks in the database spectrum, regardless of NS.

  • Complete Spectrum Search (match complete Record to Input List): a total similarity measure is calculated by comparing all NS resonances of the database spectrum with the NI chemical shifts in the input list. A max. similarity of 100% is possible only when NS = NI (identical spectra); otherwise, when NS is not equal to NI, the max. similarity measure is reduced to the factor 100*(no. of matched peaks)/(no. of matched + unmatched peaks). Thus, the similarity measure reflects how well each peak in the complete database spectrum can be paired with one value in the input list on a one-to-one basis. The Hitlist can contain not only matched spectra with NS = NI but also spectra which contain the input spectrum as a well-matched subspectrum (NI<NS, as in (1) above) or database spectra which represent subspectra of the input (NS>NI). This procedure is slower than the simple similarity search.

Example: the Input Spectrum is [24, 45, 66, 88] (four chem. shifts in ppm). Subspectrum Search: Only matching spectra will be found which contain at least 4 resonances. For example, the spectrum [24, 46, 65, 89, 95] contains the input spectrum as a subspectrum with a similarity measure of ca. 97%. Complete Spectrum Search: The following matching database spectra would be found: spectrum [23, 47, 64, 87]; similarity ca. 96% (4 of 4 resonances matched) spectrum [26, 45, 65, 90, 110]; similarity ca. 75% (4 of 5 resonances matched) spectrum [25, 45, 66]; similarity ca. 72% (3 of 4 resonances).

A spectrum search requires an input spectrum as a list of chemical shifts and (optional) relative intensities (they will be scaled to the 0-1 range automatically). One resonance per line must be entered in the Text Field provided, either manually or by Copy/Paste from another document. Both decimal point and decimal comma are allowed; shifts and optional intensities must be separated by semicolon (;) or colon (:). You can also define a spectrum type to search with the "Spectrum type to search for" drop-down box - this will limit searches to spectra of this type.

Example of an input spectrum with intensities:


You can also add a multiplicity identifier (S, D, T, Q) at the end of a line. This means that only signals will be considered as matching the multiplicity of which are the same as the given multiplicity. Notice that other multiplicities than capital SDTQ are removed, since this function is only useful with carbon spectra, where multiplicities are reliably available. Other spectra, like 1H spectra, do not have reliable multiplicities given. After the input spectrum list has been entered and the search algorithm has been chosen, click on the "Search by spectrum" button to execute the search. Instead of typing the spectrum you can also upload a jcamp file. Choose it via "Browse...", check the search type and hit "Search this spectrum" to execute the search. If the file contains a peak table, this will be used, if not, a peak picking is performed.

The dropdown box "Spectrum type to search" determines the nucleus of the spectra searched. 13C is default. Note that there is also a general type selection for more advanced users. If you use this, it must at least contain the type you choose for the spectrum search, else you will get empty results.

The error message "Your input included unallowed characters" means that your input was not correctly formatted (non-numerical characters, improper separators, empty lines). Correct your input and submit it again.

The results are displayed in the "Results" table. The molecular structures associated with the matched spectra are displayed together with the computed similarity measures. The matching performed for the similarity calculation is also displayed. If a particular molecule appears more than once, then more than one spectrum is available in the database (e.g. different solvents). For more information about browsing the results see Browsing the Results. In case of a spectrum search you have two additional informations under teh spectrum: Firstly the threshold, which means how much percent are contributed maximally by one shift and the unused signals. Unused means they did not match anything.

By using the "Browse all spectra" link you can simply browse through all structures and their spectra. Also here you can use the spectrum type selection.

2.3.2. Search by Structure

In order to search the database for molecular structures, it is first necessary to create or input a structure in an appropriate encoding format which nmrshiftdb2 understands. You can either upload a file in common formats (valid formats) via the "Browse" button or activate the Java based version via the symbol. You can then use the JChemPaint applet to interactivly paint structues. You can also import a file by Copy & Paste via the "Import text by copy &paste button".

You can enter stereochemical configurations by using solid (up) and dashed (down) wedged bonds. These will be used for total structure search, but currentliy not for the substructure search. If the total structure search finds nothing with respecting stereochemistry, it "falls back" to not using stereochemistry.

Once the desired structure has been drawn or loaded into the Marvin Sketch window, the type of search to be performed can be selected by clicking the check box next to "substructure search" (look for structures containing the input structure), "similarity search" (look for structures with a similar substructure) or "identity search" (look for structures identical to the input structure). Note that the similarity search will always be a superset of the substructure search. Click on "Search by structure" to start the search. The results are displayed on the "Results" tab. For more information about viewing results see Browsing the Results.

The drawn structures are collected in the Structures History. You can return to Marvin to make changes in the input structure or clear the sketcher window with the "Clear" command to prepare for new input.

2.3.3. Search by Molecule/Spectrum Properties

In addition to the molecular structure and numerical spectroscopic data, each database record also contains various text items called Properties (e.g., chemical name, molecular formula, spectrometer frequency, solvent, etc.). With the dropdown list box you can choose the text field to be searched (some are available in in expert mode only). A particular search is "Chemical Name (with Pubchem name resolution)", here the name entered is looked up in Pubchem and the actual search done using the InChI found. Since Pubchem is very comprehensive, this should find structures by any reasonable name. After selecting the appropriate search algorithm (see below) and entering the desired text search string, click "Search" and the results will be displayed on the "Results" tab. For more information about viewing the results see Browsing the Results.

There are three possible algorithms for the Properties Search.

  • Exact Search: All records will be found where the contents of the selected field exactly match your search string.

  • Fragment or Regular Expression Search: You may enter a specific text substring (fragment) and all records will be found which contain this substring anywhere within the selected text field. Alternatively, you may perform a more sophisticated search using Regular Expressions. For details about regular expressions, there are many good explanation in the internet, e. g. here.

  • Fuzzy Search: This is a clever combination of the Soundex algorithm, the Levenstein Distance Algorithm (LDA), and a substring search. Records will be retrieved for which the selected Text Field contains the search substring, not only on the basis of alphanumeric text but also on the basis of similarity when spoken as American english (useful when spelling is uncertain). The results are presented in the order or decreasing similarity. Due to the fuzzy nature of the algorithm, a large number of records may be found with small search strings. The Fragment Search is more efficient if the correct spelling of the search text is known.

2.3.4. Search by Chemical Formula/Multiplicities

Please note that a Chemical Formula search is a special case of the Properties search. The Regular Expression/fragment search is not allowed.

The Exact Search will retrieve all molecules whose formulas contain the same elements and numbers given in your search string, regardless of the ordering of the elements in the formula. If no number is given, one is assumed as default, so CH4 is equal to C1H4. Correct capitalization is necessary since e. g. Si is different from SI.

The Fuzzy Search requires an input string with the correct chemical elements but the associated number for each element can be given either as an exact number n, as a range of values n-p, or as a wildcard *. For example, the search string C5-7H*Br2 will find all molecules containing 5 to 7 carbons, 2 bromines and any number of hydrogens.

With "Chemical formula" respectivly "Chemical formula (with other elements allowed")" you can spedify if other elements apart from the elements given are allowed or not. With additional elements, the mentioned query will find all molecules containing 5 to 7 carbons, 2 bromines, any number of hydrogens and any other elements. In contrast, only Chemical formula will find all molecules containing 5 to 7 carbons, 2 bromines and any number of hydrogens and no other element.

The search by multiplicities works similar to the chemical formula search, but instead of element symbols you need to use symbols for multiplicities. A regular expression search is not possible. Example: S*D2-3T4 will find all molecules containing any number of singlets, two to three doublets, four triplets and no quadruplets. Note there are two multiplicity searches: The real multiplicity search, which looks for multiplicity identifiers as entered by the contributor and the potential C13-multiplicity search. This looks for multiplicities as derived from the H count, no matter what the actual data are. Possible symbols are S, D, T or Q for singlets (no H), doublets (one H), triplets (two H) or quadruplets (three H) respectivly.

You can search for molecules whose molecular weight falls within a range by giving the range like "100-200". Click "Search" and the results will be displayed on the "Results" tab.

2.3.5. Search by Keyword/Category

The search by keyword/category (expert mode only) is similar to the text string search for molecule/spectrum properties described above. However, in this case you can choose from a list of defined keywords/categories, and you can select multiple keywords/categories by holding down the "Ctrl" key. With the "Total keyword search" you search for the complete keywords, with "Keyword fragment search" all keywords containing fragments of the choosen keywords, split by blanks, will be found. Example: Keyword fragment search for "abietic acid" gives all molecules with keywords containing "abietic" or "acid".

2.3.6. Search by Condition

Here you can search for spectra with a certain measurement or calculation condition (expert mode only).

2.3.7. Search Measured or Calculated Spectra

All search procedures can be restricted to database records containing only measured or only calculated spectra, as desired, by clicking the appropriate check boxes (expert mode only). A selection will be valid till you change the settings, not just for one query.

2.3.8. Search Certain Spectrum Type / Other settings

All search procedures can be restricted to certain spectrum types (expert mode only). Check the types you want to search for by clicking the appropriate check boxes. A selection will be valid till you change the settings, not just for one query.

Here you can also determine if unreviewed spectra should be used for predictions. By default, only reviewed spetra are used. If you uncheck this box, also unreviewed get used. This can be used if you entered several spectra, which are not yet reviewed, but already want to try how this influences predictions. A selection will be valid till you change the settings and will influence the predict function as well as prediction during submit.

If the server is a Lab server (not the public servers) all searches can be restricted to submissions from the lab only. A selection will be valid till you change the settings, not just for one query.

Futhermore, there is a setting "Use .SHIFT REFERENCE in jcamp files". If this is set, SHIFT REFERENCE in JCAMP files will be used for calculating ppm. By default, it will not. We found many files contain this, but have actually already done the shifting.

2.3.9. Browsing the Results

The results of each search, i.e., the matching records retrieved from the database, are displayed in the "Results" pane in the form of molecular structures. Up to ten records can be shown per page and up to ten pages are accessible via the numerals at the top of the pane. If necessary, further blocks of ten pages can be accessed by clicking on the appropriate Arrow symbol next to the page numbers. The details of first structure on a page are shown directly. To view the details of a particular record, click on the structure of interest in the Results pane. Instead of choosing a structure you can also browse in a page with the "Browse forward"/"Browse backward" buttons.

In the right half of the Results pane the spectra for this structure are shown. If there was a set of spectra (a "dataset") measured with the same sample submitted for the structure there will be several tabs with the name of the dataset(s) visible at the top, with the spectra not in a dataset being in the "General" tab, otherwise there will be no such tabs. For each spectrum three tabs are shown:

  • Spectral Data (chosen by default): The structure is shown, together with either an image of the spectrum, if any exists (this can be enlarged via the "Show spectrum in full size" link), or a schematic stick spectrum otherwise, and a table of atom numbers and assigned chemical shifts. By clicking on the header of the atom number or shift column, you can sort the table by any column in ascending or descending order (indicated by ⇑/⇓). In a lighter color other spectra of the same type are given for compararision. On top of a structure display, there is a symobl () for switching to Java-based display. In Java mode, the correlation between atom position in the structure and chemical shift value can be viewed by hovering with the mouse over a shift value in the data table. The corresponding atom in the structure and the peak in the stick spectrum will be highlighted. Pointing with the mouse to a peak in the spectrum causes the shift value to be displayed. You can zoom or expand a desired spectrum region using the mouse to position two lines marking the left and right limits of the expansion. Click "Zoom to original size" to return to the full display. On top of a structure display, there might also be a symobl (), whch shows that there are 3D-coordinates available for this structure. They can be viewed in Java-mode. The structure shown in the Details window is shown as a graphic or, if you are in Java mode, via the JChemPaint or JMol applet, depending on if you have got 2d- or 3d-coordinates. The structure in JMol can be manipulated (scaling, translation, rotation) via a menu which can be accessed by pressing the right mouse button while in the structure window.
  • Additional Data: This gives text information about Structures (names, weight etc.) and spectrum (measurement conditions etc.).
  • Download: The download tab offers the viewing and download of structure and/or spectrum in various formats. Choose a format and click the "Request" button.
If there are several spectra of one type, they can be viewed by vertical scrolling. Order is by spectrum type. Calculated or predicted spectra come after measured spectra.

Note: the atom numbers (labels) may appear to be rather arbitrary; they are defined by the numbering scheme generated by the structure editor (depends on the order of drawing operations) or present in the mol file used as input. The numbering will most likely not correspond to IUPAC or any other systematic scheme. This is a major inconvenience when comparing data for a variety of related structures.

If you are a registered contributor, you can also add a new spectrum for an existing molecule in the database by clicking the "Add a spectrum" button. A database record of particular interest can be added to a "favorites" list by clicking the "Bookmark" button. The name of the structure will then be displayed in the bookmarks section at the top of the page and you can recall the structure by clicking it's bookmard name.

The link described as "Copy molecule link" on the bottom of the page can be used as an external link to exactly this dataset without searching for it. For copying it, use the context menu (right click with the mouse) of your browser.

2.3.10. The Search History

The search history window in the right half of the "Search" pane will keep a history of all searches performed in the current session (log-in) or, for registered and logged in users, for up to 50 searches over the current and past sessions. Single or multiple searches shown in the history window can be repeated by marking one or more check boxes and clicking the "Repeat Search" button. If multiple searches are selected, you can choose if they will be "and" or "or" combined. The "and" option menas you get all datasets fullfilling all conditions at the same time, "or" means they fullfill at least one condition. "And" should be used if you want to combine different categories, e. g. a solvent and a chemical formula. "Or" will typically be used to combine several possibilities of the same category, e. g. several solvents. You can also choose the "not" option. This will put a not in front of all conditions and therefore select everything not fullfilling the conditions. This means it will be the "rest" of the database.

2.4. Submit

In order to submit data for nmrshiftdb2, you need to be a registered user. Please do not use the "back" and "forward" button of your browser while doing a submit. To do a submit, click on the "Submit molecule" tab. You will see a timeline with various stations where you can enter data. We recommend to start from left to right, but you can always go to any station by clicking on it. If you finish one station by clicking the prominent blue button you get to the next station. Green means the data for this station have been correctly filled in (if a station is green from start, it is optional).

What you can and have to enter depends on the type of spectrum you want to submit. There are the following possibilities:

The stations on the timeline are the following:

Your data will not be available immediately, but after they have been confirmed by a reviewer (you will get an email telling you who is your reviewer). To check the status of your contributions, use the "Show all my contributions" link on the Search pane. If for some reasons your submit is interrupted, you can continue that when you log in next time. You will see a blue box on top of the submit page where you can choose to continue or to discard the broken submit.

If you are logged in, you can edit molecules you have entered. In the details portlet, you will see a button "Edit this spectrum". If you click this, you can follow the submit procedure and change anything you like. The changes need to be approved by the reviewer of the original spectrum.

2.4.1. Private submissions

You can keep data you submit private and publish them later. This can be done by checking the checkbox "I want to keep this submission private" on the final submit page. This means that the data will not be visible to anybody except you. For you, they will be found by the normal searches and can be viewed via the link "Show all my contributions" on the search page. If you view the data, you will find the export facilities in the normal place and a button "Submit for review" under your spectrum. If you press this button, the dataset will be submitted for review and will be treated like any other submit. In the details view, you can also download your data in the same formats as other data. You can also edit your data and keep them in private status. In this way, you can enter your data while working on them and only publish them once you have the final data.

A word on data protection here: Whilst we take any reasonable effort to secure our servers agains intruders, we cannot guarantee that there is no succesfull hacker attack. So we cannot take responsibility for loss or damage incured by your private data becoming known to third parties in any way.

2.5. Review

Reviews can only be done by registered reviewers. If you are one, you get notification by email about reviews assigned to you. In this email you find a direct link to the review page. You may also enter the id given in the email in the text field on the review page.

In every case you get a graphical representation of the molecule and the spectrum. You will also find the signals assigned to an atom and the predicted signals and range, as during a submit. Decide if the data seems correct and click one of buttons at the bottom of the page. "Accept" means that data will be available for searches from now, "Reject" means spectra will be deleted from the databse, "Edit and accept" gives you the chance to change things before data becomes available, with "Abort" nothing happens and with "Send" you can send an email to the reviewer. With the "Ask the contributor to edit the contribution ?"-checkbox you can decide if the user should be asked to change something in the data. Nothing happens to the data, so you will need to review them later (you will be notified if the submitter has edited the data). After a review it may take up to an hour till data actually become available for spectrum and structure searches (other searches work immediatelly).

Via the "Personal Page" link on top of the page, you can go to a list of all reviews assigned to you and not yet done. Here you can choose an unreviewed spectrum and go directly to the review page.

As a logged-in reviewer, you can edit all data by clicking the "Edit this spectrum" button in the details portlet. You can follow the input procedure and change anything. A review is not necessary.

2.6. Automatic assignment

nmrshiftdb2 can do an automatic assignment if you have a spectrum and a structure. This can help you in preparing data e. g. for a publication. To do so, you need to enter your molecule (about entering molecules see Submitting Spectra) and your spectrum as a list of shifts (ppm values) and to submit both. Your structures are collected in the structures history. The assignment is done by doing a prediction and assigning your shifts so that the similarity between the prediction and your spectrum is maximized. Therefore, the quality of the assignment depends on the quality of the prediction and the same limitations apply (see Prediction). You are then presented with the assignment in a table and a picture. If you hover over the table, an atom and its shift are marked. The table also gives the prediction for each atom and the difference of the prediction and your shift.

Once the assignment is done, you actually have an almost complete nmrshiftdb2 dataset. You are therefore encouraged to submit your data by hitting the "submit your data" link above the table. During the submit, you can also correct assignment manually and add a literature reference. Submitted data can also be exported for publication.

2.7. Quick Check

The Quick Check option offers a possibility to enter a 13C and a 1H spectrum as easily as possible and produce a quality measure for the spectra at a mouseclick. If satisfied the spectra can be submitted. A tutorial on the Quick Check is available.

2.8. Prediction

nmrshiftdb2 offers you the possibility to predict spectra of all type. The quality of the prediction depends on the database content, so for types with only a few spectra it is unlikely you get a good prediction. To do so, you need to enter your molecule (about entering molecules see Submitting Spectra) and to submit it. Your structures are collected in the structures history. You can also choose (via "Use measured and/or calulated spectra") to use only measured or calculated spectra (checking none of both options has the same effect as checking both). There might be errors in the calculated spectra sometimes, so measured only is the default choice. You are then presented with the predicted spectrum in a table and a picture. If you hover over the table, an atom and its shift are marked.

For spectrum types other than 1H the predictions are based on HOSE codes. These basically describe the neighbourhood of an atom in concentric rings ("spheres"). If two molecules have a similar neighbourhood, they will have the same HOSE code for a certain number of spheres. The number of spheres used is also given. The more spheres used, the better the prediction. Up to 6 spheres may be used; if less are actually used this means that there are no atoms with a higher number of identical spheres in the database. Since the predictions are won of similar atoms in the molecules in nmrshiftdb2, there can be multiple values for one molecule. What you get in the shift column of the table is actually the average of these. The statistics column gives also the minimum, the maximum, the median and the standard deviation of all values.

The checkbox "Use 3D hose codes" is checked by default. If this is used, a stereochemically extended HOSE code is used. This will lead to stereochemistry aware predictions with respect to double bond configurations and chiral centres. Figure 1 and Figure 2 give examples for this. Also certain diastereotopic carbons are respected (see Figure 3). Note that two requirements must be fulfilled for a stereochemistry aware prediction: you must specify the input with wedge bonds (3d coordinates, "perspective drawings" etc. will not be considered) and a matching neighbourhood must exist in the database. If this is not the case, prediction falls back to normal HOSE codes.

Figure 1. A tetrahedral centre with different predictions for atoms 24 and 31, which would be considered equal in normal HOSE codes.

Figure 2. A double bond configuration with different predictions for atoms 22 and 24, which would be considered equal in normal HOSE codes.

Figure 3. The diastereotopic atoms 8 and 9, which would be considered equal in normal HOSE codes, have different shifts.

For proton prediction apart from HOSE code, a prediction based on 3D descriptors and Support Vector Machines ("SVMs") is offered. This can give better results than HOSE codes, but should be treated with care. See this paper for details.

2.9. The rating system

In order to enable quality control by users, we have a rating system working. Every spectrum has a rating from 1 to 10, default is 10. Every registered user can "vote" on a spectrum. The rating of a spectrum is the average of all ratings, including the default rating. There are two important thresholds: If the rating is less than minimum.mark.prediction, it is no longer used for predictions, is not included in the spectrum search and does not count for the current usage statistics. If the rating is below minimum.mark.display, it needs an extra click to view it. Spectra never get deleted because of ratings. If the rating of a spectrum falls below the threshold, the administrators are notified and can check the spectrum.

2.10. The structures history

nmrshiftdb2 automatically collects the last 20 structures you painted in search by structure, predict or submit. You can load one of these structeres at any time by clicking the "Import from structures history" button next to a sketcher. You get a window where you can choose a structure. Clicking "Import" imports this and closes the import window.

The collection of stcructures is session-based, which means that structures are lost if you log in, log out or close the browser window. This is not true for registered and logged in users - they will find their old structures history if they log in again.

2.11. The Lab Administration System

nmrshiftdb2 can work as a user and order administration system for NMR labs. Note that the lab system is an additional feature which must be installed in-house. The standard nmrshiftdb2 servers do not offer it. The concept of the lab system is centered around two roles, operator and user, and the concept of an order.

Users can assign themself membership of a labgroup, either as operator or user. They need to be approved by the group leader. Once this is done, a user can submit orders and a operator can work on them.

A user, when logged in, has an additional tab "NMR lab administration". Here, he has a form which he needs to fill out to submit an order. There are three possible ways to handle an order:

The user can delete (=cancel) orders which have not yet been processed. Once an order is processed (i. e. has files assigned to it) it can not be deleted, because it is needed for statistcs. It stays in the "done orders" till a peak assignment is done. If the user does not want to do a peak assignment, he can view the order by clicking it and choose "I do not want to assign the spectra", having checked "confirm" before, which will take the order from the list as well. If the user wants to see the the orders which either have a peak assignment or where the user decided not to do it, he can choose "Also show orders already assigned" and press "Change dates/show alreayd assigned". With "I want to measure this sample again" the order is marked as not to be assigned and the user gets the submit order form, with the data of the order filled in. There is also a direct link to the Faces Scheduling System on the page, which only works, if user name and password are the same in Faces as in nmrshiftdb2

An operator, when logged in, also has the "NMR lab administration" tab. He sees a list of open orders. When clicking on one, he can assign raw data files to it and declare the order to be finished. The operator can also delete "operator"-orders. It will then disappear from the list. The worker can also view orders, which have been done by users or sample changer for a certain period. These orders can be made an "operator"-order by the operator. This is helpful in case the automatic assignment does not work (e. g. misspelled ID), it can then be processed manually. Furthermore, operators can generate statistics in pdf format.

One operator is designated as group leader; he can admit users to the group and administer the spectrometers and experiments.

In order to create a new labgroup on a machine (which must be under the administration of the group. which wants to use the feature), an entry into the labgroup table must be done manually.

Further lab system topics can be found in the nmrshiftdb2 wiki.

2.12. Miscellaneous Services

There are some miscellaneous services offered by nmrshiftdb2. These are listed here: