Changes for page Extended ISPyB (EXI)

Last modified by hakanj on 2025-11-24 09:34

From version 7.4
edited by tabermah
on 2024-12-06 09:24
Change comment: There is no comment for this version
To version 5.1
edited by tabermah
on 2024-12-06 09:06
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Extended ISPyB (EXI)
1 +ISPyB
Content
... ... @@ -1,8 +1,8 @@
1 -EXI can also be used in creating a shipment to and from P11. Creating a shipment in EXI with a complete list of Unipucks and samples can also be synched to MXCuBE and connection sample information and associated data.
1 +EXI (Extended ISPyB) can also be used in creating a shipment for a dewar to and from P11. Creating a shipment in EXI with a complete lsit of Unipucks and samples can also be synced to MXCuBE and connection sample information and associated data.
2 2  
3 3  = Logging in to EXI =
4 4  
5 -Users with a scheduled beamtime at P11 can log in to EXI at any time so create a shipment.
5 +Users with scheduled beamtime at P11 can log in to EXI at any time so create a shipment.
6 6  
7 7  * Log in with your DOOR account.
8 8  * Select the proposal you want to work with. Make sure you work with the proposal with scheduled beamtime. Sample information entered under the wrong proposal cannot be accessed during the experiment.
... ... @@ -33,7 +33,7 @@
33 33  This section describes how to enter information about the parcels, containers and samples present in the shipment. Adding the parcels must be done in order to generate the shipping label for the dewars, as described  in the **Send shipment**section in this document. However, filling up the sample details can be done while the dewars are in transit or even when they are already at DESY. Once the Unipucks are loaded in the sample changer dewar (shipment status set to “processing”) it will not be possible to change the shipment contents any longer.
34 34  
35 35  
36 -== Creating a new sample ==
36 +Creating a new sample
37 37  
38 38  If you are sending crystals of a new protein, it is important that you create an entry for the protein, since you will not be able to upload or save information from an unknown sample. To create a protein follow these steps:
39 39  
... ... @@ -42,8 +42,9 @@
42 42  * Enter the protein name and acronym and click **Save**. The name is merely descriptive and will not be used by the software.
43 43  * If you wish to enter and save the space group and unit cell, look for the protein in the list and click on the **Crystal form** tab at the right of the card. This information is not compulsory and can also be added at a later stage for each crystal in the sample information list.
44 44  
45 -== Fill the sample information in a CSV file ==
46 46  
46 +Fill the sample information in a CSV file
47 +
47 47  A practical way to enter information about the parcels, containers and samples included in the shipment is by uploading a CSV file. The upload menu is accessed by clicking the **Import from CSV** button in the shipment card. [[This example file>>url:https://lu.box.com/s/c4bpgc9ygm03wt9jhh8lu9x0rt67gh2m]] will generate a parcel called Dewar1 containing seven Unipucks fully loaded with crystals of a single protein . The example spreadsheet also contains a diffraction plan (data collection parameters that can be used for automated experiments). It is possible as well to include more than one parcel in the same file or upload separate files for different Unipucks.
48 48  
49 49  After saving the sample list, you can edit the information by going to the shipment page, clicking on the containers and selecting **Edit**. That will display the sample list for that container. You can also make corrections to the CSV file, then delete the parcel by clicking on the “Edit” icon to the right of the parcel pane and clicking on **Remove**, and finally reload the corrected CSV again.
... ... @@ -53,7 +53,7 @@
53 53  Filled up parcel in the shipment page. Use the icons to the right to add extra Unipucks, edit/remove the parcel, print the shipping labels. To import a CSV file, use the link above the parcel pane.
54 54  
55 55  
56 -== Fill the sample information online ==
57 +Fill the sample information online
57 57  
58 58  * Click the **Add parcel** button.
59 59  * Fill up the parcel name (must be unique within the shipment) and select the type (usually “dry shipper”). Then, click **Save**.
... ... @@ -71,16 +71,16 @@
71 71  * Click on the **Print labels** icon to the right of each parcel to generate a PDF file with the shipping and return EXI labels. Make sure that the information on the labels is correct. If not, go to the “Shipping addresses” list and correct the information.
72 72  * If everything is correct, print the labels. Please attach the dewar label and the shipping label on your dewars, and enclose the return label within the dewar box with other return forms (courier waybill or invoice
73 73  * If you are sending to and from **outside EU** and need customs declarations:
74 -** You need to fill in a Proforma invoice to send along with the shipment.
75 +** You need to fill in a Proforma invoice to send along with the shipment. This can be retrieved from DHL or from here: **Pro Forma Invoice to MAX IV: [[customsDeclarationProForma_sendToMAXIV.pdf>>url:https://lu.box.com/s/mzrdll406uup441g02ks9fop42wp2ypt]] **and **Pro Forma Invoice from MAX IV: [[customsDeclarationProForma_returnFromMAXIV.pdf>>url:https://lu.box.com/s/bgb7uxxza304kwoy3jzj6m4q0tc9jho7]]**
75 75  ** Be sure to use a proper description of the content of the shipment, as an example: “Dry shipper containing small frozen protein crystals for scientific experiments. Crystals are non-hazardous. Dewar contains non-flammable gas (liquid N2).”
76 76  ** Value cannot be 0, use any other small value instead (eg. 1).
77 -* The button **Send Shipment to the facility** will activate once you print the labels. When you click it, the status of the dewar will change to “sent to DESY”. This will let beamline staff know that the shipment is on its way.
78 +* The button **Send Shipment to DESY** will activate once you print the labels. When you click it, the status of the dewar will change to “sent to DESY”. This will let beamline staff know that the shipment is on its way.
78 78  * When the dewar arrives at DESY, staff will scan the EXI label, and the shipment status will be set to “Arrived”.
79 79  * You will be able to modify the shipment in EXI after shipping the dewars. However, once the Unipucks are assigned a position in the dewar and the status changes to “processing” you will not be able to make more changes. If you need to amend or update the sample information once the sample unipucks are loaded and assigned, follow these steps:
80 80  ** Create a new shipment, containing the Unipucks with the correct sample information.
81 81  ** Click on “print labels” -you do not need to actually print them, this is just to activate the “send to DESY” button.
82 82  
83 -After “sending the shipment” go to the **Prepare experiment** tab and assign the corrected Unipuck information to the actual Unipuck position in the sample changer dewar.
84 +After “sending the shipment” go to the **Prepare experiment** tab and assign the corrected Unipuck information to the actual Unipuck position in the sample changer dewar. Consult [[the MXCuBE documentation on mounting samples>>url:https://www.maxiv.lu.se/beamlines-accelerators/beamlines/biomax/user-information/mxcube3-at-biomax-user-guide/]] for more help on this step.
84 84  
85 85  = Arrange the return of dewar(s) =
86 86