MxLIVE


MxLIVE (Mx Laboratory Information Virtual Environment) is the CMCF Laboratory Information Management System you can access from home via a secure connection. 

MxLIVE is an organizational tool offered to CMCF users allowing easy organization of shipments for visits to the CLS, remote monitoring of Mail-In data collection sessions, and efficient remote control experiments.


Some of the Features:

  • Accessed using your existing CMCF account
  • Upload a spreadsheet with sample information in seconds
  • Manage samples and shipments
  • Organize and request experiments
  • Prioritize samples or experiments
  • Check shipment status
  • Inspect and download data and results from anywhere, whether doing Mail-In, remote, or on-site collection
  • Archive old experiments, shipments, or results
  • MxLIVE is fully integrated with MxDC, so results can be viewed almost immediately by your team at home


If you need assistance, please do not hesitate to contact us. We hope you find the system useful and welcome any feedback.

Interactive Tutorial

View in Your Browser

Uploading a Shipment

1. Log in to MxLIVE

  • Use your CMCF beamline account log-in information.

2. Download and Complete a Sample Spreadsheet

  • Download a blank sample spreadsheet using the "Get Template" icon in the upper right of the Project Home window.
  • You can find detailed instructions in the Specifying Sample Information section.
  • Save the file (keeping the current format).

3. Upload the Spreadsheet

  • Click on the Upload icon ().
  • Browse for your spreadsheet on the file system.
  • Specify a Dewar name and Shipment name, if you don't like the defaults.

4. Inspect the Shipment

  • Click on the Shipping tab.
  • Select your shipment from the list.
  • If you're sending a hard drive or any special tools along, click the Add Item icon () to let us know.
  • Check that everything is entered the way you want it.

5. Send the Shipment

  • Once a shipment has been sent, it can no longer be edited.
  • Print off labels using the Labels icon ().
  • Click on the Send icon ().
    • This will notify staff that your shipment is on its way.
    • If you have it, enter the tracking number for the shipment.

6. Check that the Shipment has Arrived

  • When your shipment has arrived on-site at CMCF, its status in MxLIVE will change from Sent to On-site, and your samples will be available through MxDC.

Using the MxLIVE Interface

Sample information in MxLIVE is completely editable as long as the object's status is "Draft" (when a shipment is sent, this status changes for all samples in the shipment). 

The Basics

Objects like Crystals, Experiments, Containers, Dewars and Shipments are represented by virtual objects in MxLIVE.

  • A Crystal is added to a Container (to keep track of its location) and to an Experiment (to specify how it should be tested).  You can also define cocktails or crystal forms to keep your samples organized.
  • There are three types of Containers supported in MxLIVE: Uni-Pucks, Cassettes, and Canes.  These Containers are added to Dewars.
  • A Dewar is added to a Shipment.  For sample information to be available at the CLS, dewars must be sent as part of a shipment.
  • Each Shipment can contain one or more Dewars.  Once your Shipment is "Sent" on MxLIVE, information about all of the samples in the shipment becomes available to you at the CLS.  If your shipment is still marked as "Draft", then there is no information available at the CLS about your samples.
  • Crystals are grouped into Experiments.  Different plans (Collect Best, Screen and Collect, etc) and types (Native, SAD, MAD) can be selected.

Adding Objects or Information

To add an object (check out The Basics), look for the Add icon ().  You can find the icon in a few different places:

  • In the toolbar of a list of objects, or
  • In the sidebar on certain object pages.  For example, if you click on one of your crystals, a list of cocktails is available or you can add a new one on the fly.

Clicking on an Add icon will open up a form where you can add information about a new object.  Keep in mind:

  • If a field is required, it is marked with a red asterisk (*),
  • Fields like 'Experiment' and 'Container' can easily be filled in later by dragging and dropping,
  • If you are not sure what each field describes, look for helpful information in the sidebar on the right-hand side of the form,
  • If you make a mistake, you can click on your newly created object to open this form again.


Dragging and Dropping Objects

After navigating to an object page (select the type of object in the navigation tabs at the top of the page and click on an item in the list), you will sometimes see lists of other items displayed in the sidebar.  These other items are ones that can be assigned to the object of interest. For example, crystals can be added to containers, so a container page has displayed in the sidebar a list of all of the crystals that have not yet been assigned to a container.  Other boxes appear on other pages as follows:

    • Crystal Page: Crystal Forms and Cocktails boxes
    • Container Page: Crystals box
    • Dewar Page: Containers box
    • Shipment Page: Dewars and Containers box
    • Experiment Page: Crystals box

To assign a crystal to a container, simply click and drag the crystal (from the list in the sidebar) to a container port on the main part of the page.  As you hover over a container port while dragging a crystal, the port will be shaded purple.

When dragging and dropping other objects around the site, look for icons shaded purple where objects can be dropped. 

  • left: normal experiment icon,
  • middle: drag your crystal here,
  • right: drop your crystal here to add it to the experiment.

Prioritizing Crystals or Experiments

Look for a gripper icon ( ) on tables of crystals in an experiment (on Experiment pages) or tables of experiments in a shipment (on Shipment pages).  To prioritize objects, just grab the gripper icon with your mouse and drag the table row to where you want it.  Highest priorities are at the top of the tables.

Sending a Shipment

To get access to your sample information on-site at the CMCF, you must send it in the form of an MxLIVE shipment.  Make sure your shipment contains at least one dewar, with at least one container (holding crystals).  Once your shipment is sent, you will not be able to edit any information in the shipment, but you can always add additional comments if you left out something important.

  1. Inspect the Shipment
    • Click on the Shipping tab.
    • Select your shipment from the list.
    • If you're sending a hard drive or any special tools along, click the Add Item icon () to let us know.
    • Check that everything is entered the way you want it.
  2. Send the Shipment
    • Print off labels using the Labels icon ().
    • Click on the Send icon ().
      • This will notify staff that your shipment is on its way.
      • If you have it, enter the tracking number for the shipment.
  3. Check that the Shipment has Arrived
    • When your shipment has arrived on-site at CMCF, its status in MxLIVE will change from Sent to On-site, and your samples will be available through MxDC.

Monitoring Data and Results

Look for the Status Overview panel on your Project Home page.  Datasets, results, and scans uploaded since your last login will be highlighted in the bottom row.

Viewing Diffraction Images

  • Datasets with four or more images are uploaded to MxLIVE as they are collected on the beamline.
  • To view your datasets, select Datasets from the Experiments tab, and click on a list entry.
  • Using your mouse wheel, zoom in or out, and click and drag to move along a zoomed-in image.
  • Use the buttons in the bottom panel to adjust the contrast and navigate to the next frame.
  • Download individual frames using the download icon ().
  • Verify crystal centering with pictures in the bottom right-hand corner.  Click on the picture to see another view 90ยบ away.


Viewing AutoProcess Reports

  • Screening or processing reports generated by AutoProcess through MxDC are uploaded to MxLIVE as they are completed on the beamline.
  • To view your results, select Reports from the Experiments tab, and click on a list entry.

  • View plots, charts, and data collection strategies in Screening Reports.
  • In Processing Reports, download output files (.mtz, .shelx, .cns) and view plots and charts.


Viewing Excitation and MAD Scans

  • All Excitation Scans and MAD Scans collected on the beamline are automatically uploaded to MxLIVE.
  • To find your scans, select Scans from the Experiments tab, and click on a list entry.
  • The same analysis output available on the beamline is included on MxLIVE.