This article expains:
This article includes a zipped file used as sample case.
This article is also available in Japanese.


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 .