# with proper spacing relative to the surface.
@splittableKwargsFunction()
-def move_just_onto_surface(stepper, zpiezo, Depth_nm=100, setpoint=2) :
+def move_just_onto_surface(stepper, zpiezo, Depth_nm=-50, setpoint=2) :
"""
- Uses z_piezo_utils.getSurfPos() to pinpoint the position of the surface.
- Adjusts the stepper position as required to get within stepper_tol nm
- of the surface.
- Then set Vzp to place the cantilever Depth_nm onto the surface.
-
+ Uses z_piezo_utils.getSurfPos() to pinpoint the position of the
+ surface. Adjusts the stepper position as required to get within
+ stepper_tol nm of the surface. Then set Vzp to place the
+ cantilever Depth_nm onto the surface. Negative Depth_nm values
+ will place the cantilever that many nm _off_ the surface.
+
If getSurfPos() fails to find the surface, backs off (for safety)
and steps in (without moving the zpiezo) until Vphoto > setpoint.
"""