Skip to content
PreciSim
quickstart

FAQ

Won't install, won't activate, no image, numbers don't match — work through it in this order.

Install and start-up

The camera view is black

In order:

  1. Devices → Virtual devices — is the camera connected? Hit Reconnect.
  2. Graphics driver too old for DirectX 11. Check with dxdiag.
  3. Running over RDP: some remote sessions have no hardware acceleration. Start with --render=software.

"Configuration directory is not writable"

%ProgramData%\PreciSim has no write permission. Run the app once as administrator so it can create the directory; normal privileges are fine afterwards. Do not move it into a user profile on a production PC — log in as a different Windows account and the calibrations disappear.

Activation

"Invalid licence key"

Check for transcription errors first: keys contain no I, L, O or U. What looks like O is a zero; what looks like l is a one. The app corrects those two automatically but nothing else.

"All seats in use"

Three machines per key by default. Open your account, find the machine you no longer use and deactivate it — the seat is free immediately.

The machine has no internet

Use offline activation: machine code in, activation code out, no network at any point. Steps in Install and activate.

I never got the purchase email

  1. Check spam for "PreciSim".
  2. Claim the order by number — the email you paid with is often not the email you sign in with, and that is by far the most common cause.
  3. Still nothing: write to us with the order number.

I bought source but got no repository invite

Go to Account → Source access:

  • Git account not bound yet → use "Bind with GitHub". Do not type a username; the OAuth route cannot get it wrong.
  • Bound but the status says Failed → press "Resend the invite".
  • Still failing → send us the error message shown on that page.

Calibration results

I get a different value every run

Expected. The virtual camera has a noise model, like a real one. What matters is whether the deviation is inside tolerance, not whether the number repeats exactly. If the spread is wild (mm/px jumping in the third decimal), check the number of poses — fewer than nine makes the solve unstable.

Verify passes here but the real machine is off

The virtual device can only prove your procedure and maths are right. A real machine also has things the virtual one does not simulate by default:

  • manufacturing error in the target itself (nominal 2.000 mm may actually be 1.998 mm);
  • thermal drift;
  • a camera that is not rigidly mounted, or a lens that is not locked;
  • uneven illumination biasing circle-centre extraction.

Switch these on in the error model and your procedure gets validated under conditions much closer to reality.

What order do the calibrations go in?

(7) camera focus  - no prerequisite; runs first, every later chain focuses before grabbing
(1) pixel size    - no prerequisite
      |-> (2) camera-actuator offset --+-> (6) laser focus
      \-> (3) lens distortion ---------+-> (5) galvo field correction (also needs 1 and 2)
                                       \-> (4) nine-point / hand-eye

If an earlier one is wrong, the later one cannot be right — and it will not complain. It will hand you a plausible-looking wrong number.

Integration

Can Python call vmc.dll?

Yes. It exports C-style symbols, so ctypes works directly. See Python quick start.

Can a PLC drive it?

Yes, over Modbus TCP. Register map in Modbus map. A common use is getting PLC-side logic working against the virtual machine before hardware exists.

Commercial

How long is the Pro update period?

Pro includes 12 months of updates. When they run out your licence keeps working: the versions you have, and every version released during the period, stay usable; you just stop getting newer ones. To keep updating, renew the Annual Update from your account; renewing early extends from your current end date. See EULA clause 3.

Source has no update period: pay once and every future version is a git pull away, as the source licence says.

Can I get an invoice?

International orders are invoiced automatically by our Merchant of Record. China-region orders come with a receipt (order number, amount, date) in your account, but no Chinese VAT fapiao.

Last updated: Sep 23, 2026
Was this page helpful?