Differences

This shows you the differences between two versions of the page.

--- lims-guide-data-prep-tutorial [2023/04/10 19:40] – csdunham
+++ lims-guide-data-prep-tutorial [2024/03/04 22:39] (current) – csdunham
@@ Line 1: / Line 1: @@
-==== Step-by-step tutorial: generating metadata and submitting to LIMS ====
+===== Tutorial: LIMS Data Upload =====
-Each data item submitted to the LIMS requires a metadata file.  The LIMS system provides tools to generate these metadata files.  If you are generating metadata for less than three (< 3) samples, it's recommended that you use the metadata form, as this will be the fastest method to produce your metadata files.  If you are generating metadata for more than three (> 3) samples, it's recommended that you use the metadata batch processor to generate your metadata files.  This tutorial provides step-by-step instructions for both methods.
+This is going to be revised...
-----
-==== Metadata Form (< 3 samples) ====
-  - Go to the [[https://bpm-lims.cnsi.ucsb.edu/metadata/ | LIMS metadata form]].
-  - Enter information into the form fields where necessary.
-    - **Required fields summary**:
-      - //__LIMS Account__//: The LIMS account is your account name: you can see this at the top right corner of the page. If you enter a non-existent account name, the system will tell you the account is invalid when you submit the form.
-      - //__Experimental ID__//: The experimental ID is the serial number analog for your sample. If you previously characterized your sample in the LIMS and are now submitting additional characterization information (e.g. you previously submitted an NMR spectrum and now you're submitting a mass spectrum), you **must** use the same experimental ID.  If this is a new sample, then click the "Generate ID" button to generate a new unique identifier.
-      - //__Component__//: The simplest kind of molecule/chemical species as understood by the LIMS. Specify your component by common name or PubChem CID number (the latter is preferred!) and mark its component class: monomer, solvent, catalyst, or additional reagent (i.e. other).
-      - //__Experiment, Synthesis Dates__//: The date the experiment (characterization) was performed and the date the sample was synthesized.  Recommendation: use the calendar tool over manual entry.
-      - //__Exp. Synopsis__//: A brief synopsis, or summary, of what's going on in this experiment.  Recommendation: include a truncated version of your methods and instrument parameters here.
-      - //__Synthesis Platform__//: Indicate where/how the sample was synthesized.
-      - //__Instrument__//: Indicate the instrument from which the data you are submitting was acquired.
-      - //__Data File(s)__//: Indicate which instrument data files are included as part of this metadata submission.
-      - //__Data Category__//: Indicate the manner in which the data should be interpreted (i.e., is this a spectrum, or a chromatogram, or a mean squared displacement measurement?). Data categories are used to distinguish between different data representations that might be available from a singular raw data source file.
-      - //__Data Integrity__//: Indicate whether the identity or identities of the component(s)/polymer(s)/composite is confirmed.  In other words: have you confirmed that your sample is as you've described above?  If so, mark it as verified.  If not, mark it as unverified.
-      - //__Data Availability__//: Indicate whether the data is accessible to all qualified BioPACIFIC MIP users or whether it should be restricted. __For the LIMS beta phase, all data should be marked as available to all users__.
-    - **Conditional fields summary**:
-      - //__Polymer__//: If your sample is a polymer (i.e. an assembly of multiple components), then you will provide the common name or abbreviation (or, if available, PubChem CID number) in this field.  You must also provide information concerning the following:
-        - //Polymer components//: Indicate which components belong to/were used to construct the specified polymer.
-        - //Component ratios//: Indicate the ratios of these components, expressed as either mass or mole ratios.
-        - //Chemical formula//: Provide the chemical formula, with repeating units indicated appropriately.
-        - //Molecular weight//: Provide the molecular weight in g/mol.
-        - //Polymerization mechanism(s)//: Indicate which mechanism(s) was/were employed to construct the polymer.
-      - //__Composite__//: If your sample consists of multiple polymers as part of a complex macromolecular species, then you must provide the common name your composite and include the following information:
-        - //Constituent ratios//: Indicate the ratios of the polymers used to build the composite, expressed as either mass or mole ratios.
-    - **Fully optional fields summary**
-      - Some fields are always optional.  These are highlighted in a bright, cyan blue color and can be found by clicking the document-shaped icon beside polymer and composite.  These fields include:
-        - //__Polymer__//
-          - //Tg//: The glass-phase transition temperature, in degrees C.
-          - //Polydispersity//: The polydispersity index, PDI.
-          - //Isomeric SMILES//: The isomeric SMILES string
-          - //bigSMILES//: The bigSMILES string
-        - //__Composite__//
-          - //Polydispersity//: The polydispersity index, PDI
-        - //__Context Files__//
-          - Context files are optional file attachments. These are files that provide contextual information that would help another researcher better understand the unorthodox or unique analytical interpretations you have implemented for the data you have provided.  Think of these files as "How-to" guides to help researchers understand how to understand what your data is.  Context files can be of any file format, including raw code (e.g. *.py or *.m files).
-  - After completing all of the required fields for your sample, click "Generate Metadata File".
-  - If there are no validation errors, you should see the something similar to the following at the top of the metadata form: {{:metadata-success.png?600|}}
-  - Click on the "Download Metadata" button.  This will ask you to download your formatted metadata JSON file (to either a location of your choosing, your Downloads folder, or another location -- whichever is specified by your browser settings).
-  - Move/copy/save the JSON file to the LIMS Transfer folder location on the instrument.  Consult with the project scientist and/or laboratory technician(s) overseeing the lab for more information.
-  - Copy the instrument data files to the LIMS Transfer folder.  The name of each file must match exactly with the names of the data (and context, if provided) files in the metadata file.  If the file names do not match, they will not be transferred to the LIMS.
-  - At this point, you're finished!  The system utilities of the instrument computer will take care of the rest, sending your metadata, data, and context (if provided) files to the LIMS.  After a successful transfer, the files will be archived in a separate "archive" folder inside the LIMS Transfer folder.
-----
-==== Metadata Batch (> 3 samples) ====
-  - Go to the [[https://bpm-lims.cnsi.ucsb.edu/metadata/batch/ | LIMS metadata batch processor]].