This article expains:
This article includes a zipped file used as sample case.


Here is an example on how to specify the Pupil Shift Factor.
Open the Pupil Shift Factor sample.zip file and follow these steps.
| |

2) Set the surface #1 as the global coordinate reference in the surface property window, so that the coordinate reported in the 3D layout window is referenced to surface #1, like the entrance pupil position in the Prescription Report.

3) Open the 3D layout the set the rotation to X=Y=Z=0 (default).


5) Repeat the step 4) to determine the X coordinate with the Z rotation of the 3D layout set to +90, if the stop is also shifted in the X direction with respect to the paraxial entrance pupil (not for this sample file).
6) Set the Ray-aiming to “on” and enter the estimated X Y and Z (Z estimated – Z entrance pupil) values. If you set the Ray-aiming to "on" without specifying the pupil shift factors, you will get the "cannot determine object coordinates!" error as mentioned in the beginning of the article.
X= 0, Y= +30 and Z= 29.7 – 30 (close to zero so Z=0)

This sample case is only meant to demonstrate the use of pupil shift factor. In reality, the same system can be constructed with coordinate breaks and no Ray-aiming.
This article has shown how to specify pupil shift factor when Ray-aiming. In summary:
References
1. ZEMAX User Manual .