Changes for page Extended ISPyB (EXI)

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -1,7 +1,7 @@
1	1	{{toc/}}
2	2
3	3
4		-EXI can be used for creating a shipment to and from P11. After shipment creation, the sample information can be uploaded as a csv-file for synchronization with MXCuBE during beamtime. **Note:** Even if you are bringing the dewar to DESY yourself, the shipment creation is necessary for the sample information upload.
	4	+EXI can be used for creating a shipment to and from P11. After shipment creation, the sample information can be uploaded as a csv-file for synchronization with MXCuBE during beamtime. **Note:** Even if you are using your own shipping labels, or bringing the dewar to DESY yourself, the ID label helps to identify the dewars and shipment creation is necessary for the sample information upload.
5	5
6	6	= Logging in to EXI =
7	7
...	...	@@ -46,7 +46,7 @@
46	46	* Click on **Proteins and Crystals** in the upper menu bar (Fig. 3).
47	47	* Select **Add new protein**. You can also display the **List** to check is the protein is already present.
48	48	* Enter the protein name and acronym and click **Save**. Acronym will be used by the software.
49		-* In **Proteins and Crystals, List **you find all your added proteins (you might need to refresh the page). Here it is also possible to add crystal forms, however, our MXCuBE is currently not able to use this information yet.
	49	+* In **Proteins and Crystals, List **you find al your added proteins. Here it is also possible to add crystal forms, however, our MXCuBE is currently not able to use this information yet.
50	50
51	51	[[image:CreateSample.png||height="188" width="700"]]
52	52
...	...	@@ -55,11 +55,11 @@
55	55
56	56	== Fill the sample information in a CSV file ==
57	57
58		-* After you have added all your proteins to EXI, return to your shipment by selecting **List** in the **Shipment** dropdown menu. In the list of your shipments on the left side of the window (you might need to refresh the page to show the newly created shipment) you find your shipments with the most recently created on top. Click on the shipment card you wish to work on, to open the shipment information.
59		-* While it is possible to insert all the information manually (see next chapter), the most pragmatic way is to upload a CSV file, which you can create from an excel-sheet. In EXI and here underneath you find an example of how the file should be formatted.
60		-* The upload menu is accessed by clicking the **Import from CSV** button in the shipment card (Fig. 4). The example file below will generate a parcel called Dewar1 containing seven Unipucks full of samples of different proteins. You can add multiple parcels, which are usual dewar or dry shippers, they can hold various number of containers (unipucks, if you are shipping something else, please contact the staff) and samples, which are identified after the protein acronyms you gave in the previous section. Note that the protein + sample name should be unique for the whole proposal, not just for one shipment. Errors will be marked red and this disables saving. If you run into trouble, please contact the staff.
	58	+* To add containers and sample information go back to your shipment by selecting **List** in the **Shipment** dropdown menu. That will show a list of your shipments in the left side of the window in inverse order of creation (you might need to refresh the page to show the newly created shipment). Click anywhere on the shipment card to open the shipment information.
	59	+* A practical way to enter information about the parcels, containers and samples included in the shipment is by uploading a CSV file.
	60	+* The upload menu is accessed by clicking the **Import from CSV** button in the shipment card (Fig. 4). The example file below will generate a parcel called Dewar1 containing seven Unipucks fully loaded with crystals of different proteins.
61	61	* 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.
62		-* You can also view the filled up parcel in the shipment page. Once the shipment is complete and you are ready to ship, use the icon to the right to print the shipping labels. Pressing the button next to the airplane sign 'Send shipment to the facility' notifies the beamline staff by email about incoming shipment. Please note, that you still have to order the courier yourself. The tracking code can be added e.g. to the comments field in EXI.
	62	+* You can now find the 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.
63	63
64	64	[[attach:Shipment.csv||target="_blank"]]
65	65
...	...	@@ -71,13 +71,13 @@
71	71
72	72	== Fill the sample information online ==
73	73
74		-* To add containers and sample information go back to your shipment by selecting **List** in the **Shipment** dropdown menu. That will show a list of your shipments in the left side of the window in inverse order of creation (you might need to refresh the page to show the newly created shipment). Click on the shipment card to open the shipment information.
	74	+* To add containers and sample information go back to your shipment by selecting **List** in the **Shipment** dropdown menu. That will show a list of your shipments in the left side of the window in inverse order of creation (you might need to refresh the page to show the newly created shipment). Click anywhere on the shipment card to open the shipment information.
75	75	* Click the **Add parcel** button (Fig. 4).
76		-* Fill in the parcel name (must be unique within the shipment) and select the type (usually “dry shipper”). Then, click **Save**.
77		-* Click on the **Add container** link to the right of the page (Fig. 4).
78		-* Enter the name of the container. This must be the name engraved in the Unipuck, and it must be unique within the shipment. Then select Unipuck as the type; this is the only type of container supported at P11. If shipping something else, please contact the staff and agree on this. When you save, an image of the Unipuck will be displayed in the parcel card (Fig. 5).
	76	+* Fill up the parcel name (must be unique within the shipment) and select the type (usually “dry shipper”). Then, click **Save**.
	77	+* Back at the shipment page, click on the **Add container** link to the right of the new parcel card (Fig. 4).
	78	+* Enter the name of the container. This must be the name engraved in the Unipuck, and it must be unique within the shipment. Then select Unipuck as the type; this is the only type of container supported at P11. When you save, an image of the Unipuck will be displayed in the parcel card (Fig. 5).
79	79	* Click on the Unipuck and select **Edit** This will direct to the spreadsheet form where you can list the samples in the container (Fig. 6).
80		-** Select the protein from the drop down menu. If it is not there, create a new sample as either from the Proteins and Crystals menu as described above or by clicking on the **Add Protein** button in the container sample list spreadsheet form. You might need to refresh the page to
	80	+** Select the protein from the drop down menu. If it is not there, create a new sample as either from the Proteins and Crystals menu as described above or by clicking on the **Add Protein** button in the container sample list spreadsheet form.
81	81	** Enter a sample name. It must be unique for each sample of each protein.
82	82	** After filling up the sample information, click on **Shipment** button above the spreadsheet and reply **Yes** to save the changes to the container.
83	83