| ... | ... | @@ -2,30 +2,32 @@ |
|
|
|
|
|
|
|
# content
|
|
|
|
|
|
|
|
- [Required Imports](#required-imports)
|
|
|
|
- [Kappa Initialization](#kappa-initialization)
|
|
|
|
- [Required Imports](#Required Imports)
|
|
|
|
- [Kappa initialization](#Kappa-initialization)
|
|
|
|
- [Kappa Chamber](#kappa-chamber)
|
|
|
|
- [X-ray](#x-ray)
|
|
|
|
- [Beamline and energy](#Beamline and energy)
|
|
|
|
- [Motors and Scans](#motors-and-scans)
|
|
|
|
- [mcp](#mcp)
|
|
|
|
- [vortex: multichannel analyzer (mca)](#vortex)
|
|
|
|
- [analysis](#analysis)
|
|
|
|
- [detector number](#detector-number)
|
|
|
|
- [troubleshooting](#troubleshooting)
|
|
|
|
- [Diffraction](#diffraction)
|
|
|
|
- [Kappa Detectors](#kappa-detectors)
|
|
|
|
- [Data Analysis](#data-analysis)
|
|
|
|
- [Data Scheme](#data-scheme)
|
|
|
|
- [Troubleshooting](#troubleshooting)
|
|
|
|
|
|
|
|
## Required Imports
|
|
|
|
from iexcode.macros.Kappa import *
|
|
|
|
from iexcode.macros.xrays import *
|
|
|
|
|
|
|
|
## Kappa Initialization
|
|
|
|
## Kappa initialization
|
|
|
|
run the code below in the first cell
|
|
|
|
tey,d3,d4,mesh,tth_pv,tthdet,ls331 = kappa_init('UserName', xrays=True)
|
|
|
|
|
|
|
|
## Kappa Chamber
|
|
|
|
Kappa_get_all()
|
|
|
|
Kappa_safe_state() #put Kappa chamber in a safe state
|
|
|
|
safe_state() #put the beamline in a safe state
|
|
|
|
Kappa_light(ON/OFF) #turn on/off light in Kappa chamber
|
|
|
|
Kappa_light(ON_OFF) #turn on/off the light in Kappa chamber
|
|
|
|
|
|
|
|
## X-ray optics and energy
|
|
|
|
## Beamline and energy
|
|
|
|
xrays_get_all() #get current beamline settings
|
|
|
|
energy_get_all() #get current ID and mono settings
|
|
|
|
energy_get() #return the photon energy
|
| ... | ... | @@ -43,8 +45,6 @@ |
|
|
|
-------------------------------------------------------------
|
|
|
|
resolution() #prints resolution for current setting
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
## Motors and Scans
|
|
|
|
There are seven motors in Kappa:
|
|
|
|
`mot` = `tth`, `th`, `chi`, `phi`, `x`, `y`, `z`
|
| ... | ... | @@ -71,7 +71,7 @@ There are seven motors in Kappa: |
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
## **Diffraction and Scans**
|
|
|
|
## Diffraction
|
|
|
|
-------------------------------------------------------------
|
|
|
|
wh() #print current position
|
|
|
|
pa() #print current sample orientation
|
| ... | ... | @@ -96,9 +96,7 @@ There are seven motors in Kappa: |
|
|
|
scanhkl_lst(hkl_lst) #scan a given trajectory in r-space
|
|
|
|
scanE_fixQ(hv_list, ID_tracking=False) #scan X-ray energy at a fixed Q
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
## **Detectos**
|
|
|
|
## Kappa Detectors
|
|
|
|
|
|
|
|
See below for a complete list of signals recorded during a scan and their corresponding [detector number](#detector-number) (Det Num).
|
|
|
|
|
| ... | ... | @@ -207,7 +205,7 @@ With shutter close or slit at 0 (faster), 'INPUT OFFSET' set 'ON' and 'UNCAL' |
|
|
|
- the goal is to slowly bring the gain down while keeping a non zero signal; typically a few hundred Hz
|
|
|
|
- adjust until the final INPUT OFFSET gain should be at least 1 order of magnitude lower than the SENSITIVITY with a few hundreds counts
|
|
|
|
|
|
|
|
## mcp
|
|
|
|
### mcp
|
|
|
|
|
|
|
|
```python
|
|
|
|
MPA_HV_ON()
|
| ... | ... | @@ -222,11 +220,11 @@ roi=3; MPA_ROI_SetUp(535,539,200,200,roi) #set up ROI3 = 200x200 at the center |
|
|
|
roi=4; MPA_ROI_SetUp(535,539,400,400,roi) #set up ROI4 = 400x400 at the center of MCP
|
|
|
|
```
|
|
|
|
|
|
|
|
## vortex
|
|
|
|
### vortex
|
|
|
|
|
|
|
|
For detailed instructions see [manual here](https://git.aps.anl.gov/rodolakis/Macros_29id/-/wikis/RSXS/vortex).
|
|
|
|
|
|
|
|
## analysis
|
|
|
|
## Data Analysis
|
|
|
|
|
|
|
|
### basic mda plots:
|
|
|
|
|
| ... | ... | @@ -291,7 +289,7 @@ mydata.header[3].all # return dictionary of metadata |
|
|
|
mydata.header[3].UB # return dictionary of UB metadata
|
|
|
|
```
|
|
|
|
|
|
|
|
## detector number
|
|
|
|
## Data Scheme
|
|
|
|
|
|
|
|
| Detector | Det Number Raw signal | Det Number Normalized (d/I<sub>0</sub>) | Description | PV | Controller |
|
|
|
|
|----------|-----------------------|-----------------------------------------|-------------|----|------------|
|
| ... | ... | @@ -324,18 +322,18 @@ mydata.header[3].UB # return dictionary of UB metadata |
|
|
|
| | | | | | |
|
|
|
|
|
|
|
|
|
|
|
|
## troubleshooting
|
|
|
|
## Troubleshooting
|
|
|
|
|
|
|
|
1. There is no beam.
|
|
|
|
- Make sure there is beam in the storage ring.
|
|
|
|
- Check if main shutter and branch shutter are open. If any shutter cannot be openned, Check beamline EPS and call stuff.
|
|
|
|
- Check if main shutter and branch shutter are open. If any shutter cannot be openned, Check beamline EPS and call staff.
|
|
|
|
- Check if ID and mono energy setpoints are consistent.
|
|
|
|
- Check beam on the exit slit camera from m3r_align panel.
|
|
|
|
- If there is no beam and piezo voltage is very high (-12V or 40V), try tweaking it back to zero.
|
|
|
|
- Check beam on the exit slit camera on the m3r_align panel.
|
|
|
|
- If there is no beam and piezo voltage is very high (-12V or 40V), try set it back to zero.
|
|
|
|
|
|
|
|
2. `m3r_align` doesn't work.
|
|
|
|
- This happens when the code had hard time to determine where the peak was. Try tweak the piezo voltage back to zero and adjust m3r pitch.
|
|
|
|
- When the photon energy is too high (> 2.3 keV), or the mono and ID energies are very different, photon counts can be too low to determine the peak position. Try increasing exposure time (`t(s)` on the screen) of the camera.
|
|
|
|
- This happens when the code had hard time to determine where the peak is. Try tweaking the piezo voltage back to zero and adjust m3r pitch.
|
|
|
|
- When the photon energy is too high (> 2.3 keV), or the mono and ID energies are very different, photon counts can be too low to determine the peak position. Try increasing gain and exposure time (`t(s)` on the screen) of the camera.
|
|
|
|
|
|
|
|
3. ID gets stuck.
|
|
|
|
- Change mode on the ID screen (`IEXMachinePhysics.adl`), wait until it's done, and change the mode back. This will reset the ID.
|
| ... | ... | |