AGENT SKILL
nikon-pfs
Safely find, engage, verify, and tune Nikon Perfect Focus System focus locks.
- License 许可
- BSD-3-Clause
- 最近更新
- 2026-10-20
- Stars
- ★ 10
- Forks
- 1
01 前言 Front Matter
- name
- nikon-pfs
- description
- Safely find, engage, verify, and tune Nikon Perfect Focus System focus locks.
03 SKILL.md 正文
Nikon Perfect Focus System (PFS) reference
Returned by load_skill(name="nikon-pfs").
Nikon rigs:
- Nikon systems often use the Perfect Focus System (PFS) as the focus lock. If you see TIPFS hardware, use run_autofocus with its property probe to identify the capture range. TIPFSStatus-Status tells you if you are focusing, regardless of whether or not the PFS is on. Pass the status device, property, and its exact in-range values to probe; use method='sweep' and a reviewed wide window. Name only steady in-range states, never a transient one the status reports while the lock is engaging. The sweep stops at the first plane that reads in range and leaves Z there, so it costs no exposures and does not sweep the rest of the window; size the step to the capture range you expect rather than defaulting to a fine one. Once it is in range of focus, the focus lock can be engaged, and engaging it is what confirms the plane.
- Once the PFS is on, use an image-based focusing metric to confirm there is signal. You can use the PFSOffset to fine tune the focus, using image-based focusing metrics to improve the contrast.
- Because the PFS relies on reflection off of the cover glass to identify if it's in focus, it may be possible to find the focus at too high of a position, where the objective has a actually pushed the coverslip up at an angle. To check that this is not the case, you can check if there is signal with an image-based focusing metric and you can jog the stage a little bit (~10 um or up to half the field of view in both X and Y) and see if the PFS stays on. Do BOTH of these every time you engage the lock, as steps, not as caveats you mention and skip. If it stops working after a little movement, the position might be too high. You can try finding a different PFS a bit lower. It also could be the case that there's an air bubble in the oil or some other refractive index variability in the oil or sample. In this case, you won't successfully find a lower PFS position.
- Note that the PFS offset range is around 10 micrometers for oil immersion objectives, 20 micrometers for water immersion objectives, and up to 100 micrometers or more for dry objectives. These numbers decrease with increasing numerical aperture of the objective. That offset range is not the width of the status property's in-range capture band. Measure the capture band with the property probe; do not substitute the offset-range number for it.