Changes for page CFEL TapeDrive: Serial Crystallography

Last modified by chatzies on 2025-11-27 11:35

From 43.1 to 44.1 From 65.1 to 66.1

From version 44.1

edited by ahenkel
on 2021-12-12 23:50

Change comment: There is no comment for this version

To version 65.1

edited by ahenkel
on 2022-05-05 19:37

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)
Objects (1 modified, 0 added, 0 removed)
- Confluence.Code.ConfluencePageClass[0]

Details

Page properties

Content

@@ -1,79 +1,33 @@
  {{layout}}
  {{layout-section ac:type="single"}}
  {{layout-cell}}
--[[image:attach:TapeDrive_beschriftet-tile.jpg||height="250"]]
++[[image:attach:TapeDrive_beschriftet-tile.jpg||height="400"]]
  \\
--\\
++{{toc minLevel="2"/}}
  \\
--=== {{id name="14.SerialCrystallography:CFELTapeDrive-14.1RevertfromCrystallographytoTapeDrive(P11staff/CFEL)"/}}**14.1 Revert from Crystallography to TapeDrive (P11 staff/CFEL)** ===
++----
--* remove vortex
--* beamstop to out-position?
--* remove goniometer. The airbearing should be stopped (p11/servermotor/eh.1.01)
--* move cryojet out of the way, ramp the cryo up and shut it down. Close the compressed air to the shield flow. The biggest cable kinks and needs to be disconnected.
--* stop refill of the robot dewar and empty the dewar, warm up.
--* Disable backlight (unplug Festo connection). (% style="color: rgb(255,0,0);" %)//Is this still needed?//
--* (% style="color: rgb(0,0,0);" %)mount the 10 um diode and connect (via connector on the granite). This is connected to the leftmost Keithly (power up, check that settings are gain E06, Filter on, Rise time 1 ms. Keithly is connected to the oscilloscope and the delay generator, delay generator is connected to oscilloscope and detector, see diagram in P11 wiki. (% style="color: rgb(0, 0, 0); color: rgb(255, 0, 0)" %)//Insert here the setting for oscilloscope//(% style="color: rgb(0,0,0);" %)//. //Make sure to connect the multi-trigger to the back of the detector instead of the standard trigger, when starting to use the chopper (pull the thin ring with ‘grip’ area to detach). Cables are labeled. Make sure before using the chopper that the channels are enabled.
--* (% style="color: rgb(0,0,0);" %)move goniotower to X ~~ 17 000
++== {{id name="14.SerialCrystallography:CFELTapeDrive-14.1Samplecharacteristicsandpreparation"/}}**14.1 Sample characteristics and preparation** ==
--(% style="color: rgb(0,0,0);" %)Mounting of the TapeDrive is done by the CFEL group. Electronics and control units are combined on a small shelf, that requires only one power and network plug-in. The shelf will be placed left-sided (looking upstream) to the detector tower. The ElveFlow and control laptop as well as several necessary consumables are placed on a cart, which is to be positioned on the right (looking upstream) against the robot platform. The CFEL chiller is placed on the right of the platform and connected to the TapeDrive GASnozzle.
++suspension of microcrystals, **at least** 200 µL with 20% crystal density (more is always better), size range: 2-30 µm, **tip:** bring some mother liquor for washing, filtering, diluting etc.
--\\
--
--* adjust focus of the tape by moving X in goniometer tower until you see it in the overview camera. Final adjustment should be done when there is flow. Latest value is about 4500 in X and also 5000 in Z (higher soft limit changed from 2976,63 to 6000). (% style="color: rgb(255,0,0);" %)//Better to use the back illumination in the GUI to focus the tape - old instruction, not sure if this is the case. Back illumination is the external light source in the detector tower (the crystallography backlight should be disable for tapedrive).//
--* (% style="color: rgb(0,0,0);" %)Check the Minimum Detector Distance; the detector should not collide with the tapedrive while driven to 154 mm but it has to be verified. Also check that all cables and capillaries are taped away when the users start, so that nothing protrudes further than the tapedrive itself. Soft limit can be edited in eh.3.11 Atk panel.
--* (% style="color: rgb(0,0,0);" %)Reconfirm the alignment of the beamstop, once everything, including the nozzle, is in place. Modify config.ini for beamstop in- and out-position to both mach in (27 000). This way the beamstop will not be driven out when the hutch is opened, to avoid that the users forget to drive it in when restarting after entering the hutch.
--
--\\
--
--Prepare necessary controls for data collection:
--
--* ATK panels:
--** p11/simplon_filewriter/eh.01
--** p11/simplon_detector/eh.01
--*** count time = 0.0075
--*** trigger (**ints **if working without the chopper, # or triggers is 1, **exts** if with the chopper, # or triggers = number of images). Exts is also the standard trigger in normal crystallography. If GUI is used to take images (e.g. for beamstop alignment) the trigger mode will be forced by that and needs to be reverted manually for the users to continue.
--*** numer of images = 100 000
--*** number of images in container = 1000
--*** mode 16m/4M
--*** detector distance = 200 mm (usually)
--** p11/detectortower
--** p11/motor/eh.09
--* remote access to TapeDrive control laptop:
--** open terminal, execute command:          xfreerdp +clipboard /size:1920x1080 /u:Cfelusr /v:cfeld-pcx22611
--                                                             password: //written on control laptop
--//
--* Cameras:
--** haspp11ethcam1 → detector tower camera to monitor nozzle
--** haspp11ethcam4 →  goniometer camera to monitor tape from above
--* OnDa (on haspp11user04):
--//This starts both GUIs (Frame Viewer & Crystallography GUI) and onda-monitor, the server component. The tool has a bunch of parameters which you can list with ./onda-runner.py —help.//\\
--** 16M mode →    cd /home/p11user/CfelSoft/202103_onda
--                         ./onda-runner.py onda-config/onda-config-Eiger16M.toml
--** 4M mode   →    cd /home/p11user/CfelSoft/202103_onda
--                         ./onda-runner.py onda-config/onda-config-Eiger4M.toml\\
--
--\\
--
--=== {{id name="14.SerialCrystallography:CFELTapeDrive-14.2Samplecharacteristicsandpreparation"/}}**14.2 Sample characteristics and preparation** ===
--
--suspension of microcrystals, **at least** 200 µL with 20% crystal density(more is always better), size range: 2-30 µm, **tip:** bring some mother liquor for washing, filtering, diluting etc.
--
  Preparation:
--* filter through 30 µm cell filter (green) into Eppendorf or Falcon (original!) tube
++* filter through 30 µm cell filter (green) or 50 µm (yellow)   into Eppendorf or Falcon (original!) tube
  [[image:attach:20211201_095534.jpg||height="250"]]
  \\
--=== {{id name="14.SerialCrystallography:CFELTapeDrive-14.3ConnectingsampletoElveFlow,sampleexchange"/}}**14.3 Connecting sample to ElveFlow, sample exchange
--** ===
++----
++== {{id name="14.SerialCrystallography:CFELTapeDrive-14.2ConnectingsampletoElveFlow,sampleexchange"/}}**14.2 Connecting sample to ElveFlow, sample exchange
++** ==
++
  After filtration, screw the ElveFlow connector to your Eppendorf or Falcon tube. Make sure that the yellow-ish line goes to the bottom of your tube. You can adjust the length by unscrewing the blue fitting on top and pushing/pulling the yellow-ish line. **Don't forget to tigthen the blue fitting afterwards!**
  Be aware to which channel and nozzle line your sample is connected.
@@ -90,9 +90,11 @@
  \\
--=== {{id name="14.SerialCrystallography:CFELTapeDrive-14.4TapeDriveoperation"/}}**14.4 TapeDrive operation
--** ===
++----
++== {{id name="14.SerialCrystallography:CFELTapeDrive-14.3TapeDriveoperation"/}}**14.3 TapeDrive operation
++** ==
++
  The TapeDrive is controlled through kamzik. To open kamzik, start the server. A terminal will open and shortly after a small window.
  Now start the client. Same thing, a terminal will open, shortly after a small window.
@@ -99,9 +99,9 @@
  Click 'Devices' in the **client session** to open the control window.
  [[image:attach:screen.PNG||height="250"]][[image:attach:server client.PNG||height="250"]]
--**Tape**
++==== {{id name="14.SerialCrystallography:CFELTapeDrive-Tape"/}}**Tape** ====
--* Click on the 'main tape' icon
++* Click the 'main tape' icon
  * Change the velocity by typing anything from **0.3-3.0 mm/s**
  * Common velocity is 1.0-1.5 mm/s
  * kamzik displays the used tape in m and %. At 98% the tape will automatically stop since the rolls need to be exchanged at this point.
@@ -110,7 +110,7 @@
  ==== {{id name="14.SerialCrystallography:CFELTapeDrive-Samplenozzle"/}}**Sample nozzle** ====
--* Click an the 'nozzle' icon.
++* Click on the 'nozzle' icon.
  * (((
  The nozzle position can be adjusted in xyz by clicking on the arrows up and down. (Double arrow = 10 steps). Step size can be varied, 1mm steps are rather big and should be used carefully.
  The absolute position is **not calibrated** and therefore changes after each restart of kamzik.
@@ -189,8 +189,10 @@
  \\
--=== {{id name="14.SerialCrystallography:CFELTapeDrive-14.5Taperollexchange"/}}**14.5 Tape roll exchange** ===
++----
++== {{id name="14.SerialCrystallography:CFELTapeDrive-14.4Taperollexchange"/}}**14.4 Tape roll exchange** ==
++
  The tape stops automatically at 98% used length, if you need to change the rolls for orther reasons, stop the tape (velocity = 0.0 mm/s).
  * Remove the (almost) empty feeder roll by pulling it upwards.
@@ -198,7 +198,7 @@
  * Get a new tape roll (bottom left on the cart). **Polypropylen 15 µm**
  * Cut the first cm of the new tape roll, directly behind the black sticky part.
  * Place new roll on roll holder and use sticky tape to attach the end of the old tape to the beginning of the new roll.
--* Open magnetic tape stabilizer on the **left side**. //!!!BEAMSTOP!!!//
++* Open magnetic tape stabilizer on the **left side**. (% style="color: rgb(255,0,0);" %)//!!!BEAMSTOP!!!//
  * Start the tape (3mm/s). Once the connetion side has arrived at the collector roll, stop the tape (0mm/s).
  * Again, cut the tape directly behind the connection side. Replace the the old roll with the **empty **one. Old roll can be discarded.
  * Attach new tape to the empty roll by using some sticky tape.
@@ -212,15 +212,17 @@
  \\
--=== {{id name="14.SerialCrystallography:CFELTapeDrive-"/}}**
--** ===
++**
++**
  {{/layout-cell}}
  {{/layout-section}}
  {{layout-section ac:type="single"}}
  {{layout-cell}}
--=== {{id name="14.SerialCrystallography:CFELTapeDrive-14.7Chopper"/}}**14.7 Chopper** ===
++----
++== {{id name="14.SerialCrystallography:CFELTapeDrive-14.5Chopper"/}}**14.5 Chopper** ==
++
  start chopper gui from terminal:
  (% class="code" %)
@@ -231,6 +231,7 @@
  (% class="code" %)
  (((
              python chopperControl.py
++\\\\
  )))
  {{/layout-cell}}
  {{/layout-section}}
@@ -253,13 +253,14 @@
  * (% style="color: rgb(0,0,0);" %)set "Hole" to <Inner hole (largest)> (% style="color: rgb(255,0,0);" %)//Takes some minutes//
  * (% style="color: rgb(0,0,0);" %)increase frequency by max. 10 Hz steps
  ** (% style="color: rgb(0,0,0);" %)click arrow up 10x, "Set", arrow up 10x, "Set", .....
--* (% style="color: rgb(0,0,0);" %)//usually 133 Hz, results in exposure time of 3.7 ms//
++* (% style="color: rgb(0,0,0);" %)//usually 133 Hz, results in exposure time of 3.7 ms (technical exposure will always be 7.7 ms, since max. frame rate is 133 Hz
++//
  {{/layout-cell}}
  {{/layout-section}}
  {{layout-section ac:type="single"}}
  {{layout-cell}}
--=== {{id name="14.SerialCrystallography:CFELTapeDrive-14.8Datacollection"/}}**14.8 Data collection** ===
++== {{id name="14.SerialCrystallography:CFELTapeDrive-14.6Datacollection"/}}**14.6 Data collection** ==
  Once the hutch is interlocked, set remote control to the TapeDrive laptop by opening a terminal and executing the following command:
@@ -269,33 +269,47 @@
                        password: written on control laptop (changes every 6 months)
  )))
--                                           //>>usually the terminal is open, just repeat previous command with arrow up, enter and type in the password//
++                               //>>usually the terminal is open, just repeat previous command with arrow up, enter and type in the password//
  \\
--
--Click "Start" icon in kamzik.
--
--[[image:attach:kamzik_run-tile.jpg||height="400"]]
--
------
  {{/layout-cell}}
  {{/layout-section}}
--{{layout-section ac:type="two_equal"}}
++{{layout-section ac:type="two_left_sidebar"}}
  {{layout-cell}}
  **Check list:**
  (% style="color: rgb(255,0,0);" %)//always after entering the hutch!//
--* Open BS1  (//CrystalControl)//
--* Put collimator in (//CrystalControl)//
--* Check beamstop position = 27 000 (//Atk panel p11/motor/eh.3.09)//
--* Open fast shutter (//CrystalControl)//
--* Check diode voltage ~~ 0.0 (//kamzik Run/Diode voltage)//
--* Close fast shutter (//CrystalControl)//
++(% style="color: rgb(0,0,0);" %)Click "Safety" icon in kamzik.
++* Put collimator in
++** Click "<Call>" next to //collimator_in//
++
  \\
++* Open beam shutter BS1 in //CrystalControl //or// P11 XRayFeed //
++{{/layout-cell}}
++
++{{layout-cell}}
++[[image:attach:kamzik_safety.PNG||height="400"]]
++{{/layout-cell}}
++{{/layout-section}}
++
++{{layout-section ac:type="single"}}
++{{layout-cell}}
++----
++
++Click "Start/Run" icon in kamzik.
++
++[[image:attach:kamzik_run-tile.jpg||height="400"]]
++
++----
++{{/layout-cell}}
++{{/layout-section}}
++
++{{layout-section ac:type="two_equal"}}
++{{layout-cell}}
  **Set run parameters and go 🏃💥**
 . Set your desired No. of frames
@@ -306,19 +306,17 @@
  \\
--(% style="color: rgb(153,51,102);" %)**//Current bug~://**
++\\
--(% style="color: rgb(0,0,0);" %)You need to "Stop" run in kamzik manually after all images have been acquired. This moves the shield up and closes the fast shutter. Afterwards you can start a new run by clicking "<Call>".
++**After data collection/Before entering the exp. hutch:**
++1. Go to "Safety" in kamzik.
++1. Click "<Call>" next to //prepare_to_open_hutch. //This will automatically:
++11. Drive the collimator out
++11. Drive the detector back to 1500 mm
++1. Close beam shutter BS1 and break door interlock in //P11 XRayFeed //(monitor top left).
--(% style="color: rgb(0,0,0);" %)Check progress in terminal with:
--
--(% class="code" %)
--(((
--      cd /gpfs/current/raw/scan_frames
--      watch "ls -lrt <run number>/ | tail"
--\\\\\\\\
--)))
++[[image:attach:Screenshot from 2022-04-04 19-36-29.png||height="400"]]
  {{/layout-cell}}
  {{layout-cell}}
@@ -346,7 +346,7 @@
  \\
  )))|(% colspan="1" %)(((
--chopper at 133 Hz → 3.7 ms
++chopper at 133 Hz → 7.7 ms (opening time will be 3.7)
  chopper at 66 Hz   → 7.7 ms
@@ -375,15 +375,6 @@
  )))|(% colspan="1" %)(((
 .0 mm   (% style="color: rgb(255,0,0);" %)confirm with //enter//, click "<Call>"
  )))
--|(% colspan="1" %)(((
--Diode voltage
--)))|(% colspan="1" %)(((
--read out of diode
--)))|(% colspan="1" %)(((
--**~~ 0   !!! higher values indicate missaligned beam stop!!!
--Call local contact
--**
--)))
  {{/layout-cell}}
  {{/layout-section}}
@@ -391,7 +391,7 @@
  {{layout-cell}}
  ----
--=== {{id name="14.SerialCrystallography:CFELTapeDrive-14.9Troubleshooting"/}}14.9 Troubleshooting ===
++== {{id name="14.SerialCrystallography:CFELTapeDrive-14.7Troubleshooting"/}}**14.7 Troubleshooting** ==
  * (((
  ==== {{id name="14.SerialCrystallography:CFELTapeDrive-Tapestopped"/}}Tape stopped ====
@@ -419,6 +419,41 @@
  * Sample empty?
  * Nozzle or lines clogged? → flush with water, change nozzle
  )))
++
++\\
++
++* (((
++==== {{id name="14.SerialCrystallography:CFELTapeDrive-Simplonfilewriter/eigerstreamissues"/}}Simplon filewriter/eiger stream issues ====
++
++* First, restart kamzik (server+client) and see if this solves the issue
++* If not, restart the Simplon server (in Astor → haspp11exp03, right click on Simplon/EH.1 and restart)
++* (((
++If nothing works, kill the Simplon process and then start the server again:* (((
++(% class="code" %)
++(((
++ssh haspp11exp03
++)))
++)))
++* (((
++(% class="code" %)
++(((
++ps -ef | grep Simplon
++)))
++)))
++* (((
++(% class="code" %)
++(((
++kill -9 simplon_process_id
++)))
++)))
++)))
++)))
  {{/layout-cell}}
  {{/layout-section}}
++
++{{layout-section ac:type="single"}}
++{{layout-cell}}
++\\
++{{/layout-cell}}
++{{/layout-section}}
  {{/layout}}

Confluence.Code.ConfluencePageClass[0]

Id

@@ -1,1 +1,1 @@
--236824593
++254728507

URL

@@ -1,1 +1,1 @@
--https://confluence.desy.de/spaces/11/pages/236824593/14. Serial Crystallography: CFEL TapeDrive
++https://confluence.desy.de/spaces/11/pages/254728507/14. Serial Crystallography: CFEL TapeDrive

Changes for page CFEL TapeDrive: Serial Crystallography

Summary

Details

Applications

Navigation