Thorlabs Wavefront Sensor - Readme 
Use this software to operate the Thorlabs WFS Wavefront Sensors.

Note:
This software comes with additional software packages:
	- NI LabWindows/CVI runtime engine (http://www.ni.com/lwcvi)
	- NI VISA Runtime engine (http://sine.ni.com/psp/app/doc/p/id/psp-411)

License:
This software is copyright Ó 2007-2023, Thorlabs GmbH. For license details please see file License.rtf.

Supported platforms:
This software was verified with the following platforms:
	- Windows 10 (32 and 64-bit version)
	- Windows 11	

Changelog
Aug-23-2023 - Release V6.0
     Changes to V5.7
   - Support for new model WFS31

May-05-2023 - Release V5.7
     Changes to V5.6
   - bug fix: driver functions are changing Windows current directory - solved

Jul-07-2022 - Release V5.6
     Changes to V5.5
   - bug fix: names for Zernike Z8,Z9: 'Coma y' and 'Coma x' exchanged

Apr-01-2021 - Release V5.5
     Changes to V5.4
   - bug fix: HW trigger mode for WFS20
   - bug fix: 'Parameter out of range' error, pupil size

Jul-09-2019 - Release V5.4
     Changes to V5.3
   - bug fix: error when Zernike orders set to auto

Mar-11-2019 - Release V5.3
     Changes to V5.2
   - bug fix: DotNet driver corrected
   - bug fix: trefoil wavefront errors reduced

Aug-31-2018 - Release V5.2
     Changes to V5.1
   - bug fix: 64bit driver crash on Win10

Aug-17-2018 - Release V5.1
     Changes to V5.0
   - bug fix: missing LabView 'calibration' functions added
   - bug fix: calculate fit error also in WF 'measured' mode

Jul-19-2018 - Release V5.0
     Changes to V4.6.3
   - Support for new models WFS30 and WFS40
   - fixed camera timeout errors

Feb-05-2016 - Release Candidate V4.6.3
      Changes to V4.6.2:
   - driver sets working directory for WFS_SaveUserRefFile() and WFS_LoadUserRefFile() internally to
      C:\Users\<user_name>\Documents\Thorlabs\Wavefront Sensor\Reference 

Feb-04-2016 - Release Candidate V4.6.2
      Changes to V4.6.0:
      - prevent crash when invalid centroid data are set to user reference
      - ability to save spotfield images to various file types

Oct-23-2015 - Release V4.6.0
      Changes to Release Candidate V4.6.0:
      - updated manual
      - Installation and operation is no more guaranteed for Windows XP

Sep-11-2015 - Release Candidate V4.6.0
      Changes to V4.5.0:
      - new trigger mode 'Software Trigger', reduces measurement delay for WFS10/20
      - installer includes DataSocket V4.8 packet, replaces buggy V4.6
      - manual not yet updated

Jul-09-2015 - Release V4.5.0
      Changes to V4.4.0:
	- WFS installer generates a registry entry to indicate the DMP40 software an existing installation
	- VISA 5.4.1 is supplied with the installer package
	- workaround to prevent WFS20 error #17 (FPGA error)
	- increased USB timeout for WFS150/300 cameras
	- bug fix: "Par. 3 out of range!" when switching from WFS20 to other WFS
	- improved 'Cancel Average WF Tilt' option, takes only spots within pupil and AOI into account (less noisy)

Feb-03-2015 - Release V4.4.0
      Changes to V4.3.0:
	- WFS150/300 works with USB3, but at reduced speed (!) and increased min exposure time

Jan-13-2015 - Release V4.3.0
      Changes to V4.2.0:
	- Bugfix: LineView returns single column, fixed
	- uc480 cam driver update to V4.40, now compatible to ThorCam V2.4

Sep-19-2014 -Release V4.2.0
      Changes to V4.1.2:
	- generated with TeamCity InstallShield
      - error "Spot centroids mismatched to highspeed calculation windows!" arises only if mismatch was within the pupil            
      - bug fix: crashes in WFS_CalcSpotsCentrDiaIntens() removed
	- C# sample added

Jun-24-2014 - Prelim Release V4.1.2
	Changes to V4.1.1:
	- files location switched to C:\Users\myname\Documents\Thorlabs\Wavefront Sensor\
	- change WFS20 min. resolution to 360x360 -> get 5x5 spots with MLA300
	- improved WFS20 exposure inrcrements

Mar-13-2014 - Prelim Release V4.1.1
	Changes to V4.1:
	- Bad Pixel correction added for WFS20
	- WFS20: max. cam resolutions increased to 1440x1080 and 1080x1080
	- bug fix: Zernike calculation error for pupil diameter close to image size removed

Feb-27-2014 - Release V4.1
	Changes to V4.0:
	- Support of new fast WFS20
	- Binning 2x enabled for WFS20
	- Area of Interest (AOI) functionality added

Mar-05-2013 - Internal Release V4.0
	Changes to V4.0:
	- VXIpnp functions added

Sep-24-2012 - Release V3.6
	Changes to V3.5:
	- bug removed: error occurred when WFS_CalcWavefront() is called with option limit_to_pupil_interior=1 after pupil change
	- bug removed: unsuccessful loading a user ref. file now generates WFS_ERROR_NO_USER_REFERENCE error on further usage
	- driver function WFS_GetMlaData() extended by two more parameters
	- increased accuracy for parameter RoC due to extended WFS calibration

Apr-23-2012 - Release V3.5
	Changes to V3.2:
	- new driver function WFS_SetCalcSpotsToUserReference()
	- driver function WFS_ErrorMessage() now returns "Parameter # out of range!" or "Unknown error!"
	- Bug fixed: "Par. 2" error in WFS150/300 trigger mode
	- updated manual and driver support

Jun-24-2011 - Release V3.2
	Changes to V3.1:
	- Power distribution can be saved to .csv file
	- uc480 camera driver updated to V3.80
	- Bad Pixel correction improved for WFS150/300 series

Dec-22-2010 - Release V3.1
	Changes to V3.0:
	- Bad Pixel correction enabled for WFS10 series

Dec-10-2010 - Release V3.0
	Changes to V2.3:
	- Support of WFS10 Fast Wavefront Sensor instruments
	- BeamView axes and field of view enlarged to outer lenslet border
	- BeamView height / width ratio corrected
	- New warnings "Low spot count within pupil..." and "Pupil badly filled with spots..."

Oct-12-2010 - Release V2.3
	Changes to V2.2:
	- Undetected spots in Beam View colored black

Sep-23-2010 - Internal Release V2.2
	Changes to V2.1:
	- Number of spots depending on camera resolution reduced
	- Bug fixed: 'start' symbol in toolbar was dimmed when display tab was changed

Apr-14-2010 - Release V2.1
	Changes to V2.0:
	- Combined install package for application, instrument driver and camera USB driver
	- Default installation directory modified
	- Signed driver package for 32 and 64 bit Windows versions

Dec-11-2009 - Release V2.0
	Changes to V1.4:
	- Support of new model WFS300-14AR with exchangeable Microlens Array
	- Support of multiple Microlens Array calibrations within one WFS instrument
	- Separate instrument driver WFS_Drv available, LabView support and samples
	- Bug removed: Zernike results went high when pupil y position was shifted off-center
	- Trigger functionality added
	- DataSocket interface: centroid array data type changed from double to float

Jun-24-2009 - Release V1.4
	Changes to V1.3:
	- Support of new models WFS150-7AR and WFS150-5C
	- Bug fixed: Zernike results were always related to image center, now related to pupil, also when off-center!
	- Bug in driver version comparison fixed
	- Required camera driver version updated to 3.32
	- Live spot centroid data transfer added to DataSocket interface
	- Max size of centroid data arrays reduced by 1 (same size as wavefront array)
	- DataSocket config stored in registry
	- Configurations file (.cfg) enables storage and reload of application settings
	- Wavelength range limited to 300 - 1100 nm (WFS150-5C)

Dec-17-2008 - Release V1.3
	Changes to V1.2:
	- Program shut down in case of busy computer prevented by longer timeout of 10 sec
	- New camera driver uv480 version 3.30 provided and required
	- uc480 Camera Manager.exe is removed after camera driver installation to prevent erasure of WFS calibration data
	- Wavefront color spectrum relates to manual set min and max z-axis, not to wavefront data content
	- Extend allowed exposure range to 65 ms

Dec-06-2007 - Release V1.2
	Changes to V1.1:
	- Usage of updated camera driver version 3.10
	- Bug removed: fixed wavefront unit in 3D diagram, .csv file and via DataSocket (switch from µm to waves failed)
	- Control 'Hide data outside pupil' in wavefront graph config removed,
	  function is now bound to setup control 'Limit wavefront calculation and display to pupil interior'
	- BeamView graph improved, undetectable spot areas are displayed now black without strong color gradients
	- Bug removed: off-center pupil position caused calculation error in wavefront statistics 
	- Wavefront output in csv file in normal order: y array index increases downwards but y-coordinate increases upwards

Nov-07-2007 - Release V1.1
	Changes to V1.0:
	- All panel colors 'Conform to system colors' 
	- Measurement data file: added with x- and y-scale around wavefront data array
	- Measurement data file: wavefront data array is limited to pupil interior if option is enabled
	- Measurement stop updates also hidden graphs
	- Bug removed: sign of y beam centroid corrected, mirrored pupil y position in beam view
	- Bug removed: too long spot shifts displayed at highest resolution
	- Bug removed: re-calculation of pupil when bound to beam diameter or centroid

Oct-25-2007 - Release V1.0