Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
mgl:moncalib [2017/03/24 12:57]
mgl:moncalib [2024/02/09 12:13] (current)
joshryu0425
Line 28: Line 28:
 | [[http://​www.photoresearch.com|Photo Research SpectraScan 650]] |{{:​mgl:​pr650.jpg|}} | | Can make a full set of measurements (including full spectrum measurements) and is considered the gold standard. Our software may work with other models from PhotoResearch,​ but this is the one we have typically used | | [[http://​www.photoresearch.com|Photo Research SpectraScan 650]] |{{:​mgl:​pr650.jpg|}} | | Can make a full set of measurements (including full spectrum measurements) and is considered the gold standard. Our software may work with other models from PhotoResearch,​ but this is the one we have typically used |
 |[[http://​www.topcon-techno.co.jp/​en/​products/​op_meas/​sr-3ar.html|Topcon SR-3A-L1 Spectroradiomter]] | {{:​gru:​topcon.jpg|}} |{{:​gru:​topcon.pdf|English manual}} | Similar to the PR650 in capabilities | |[[http://​www.topcon-techno.co.jp/​en/​products/​op_meas/​sr-3ar.html|Topcon SR-3A-L1 Spectroradiomter]] | {{:​gru:​topcon.jpg|}} |{{:​gru:​topcon.pdf|English manual}} | Similar to the PR650 in capabilities |
-| [[http://​sensing.konicaminolta.us/​products/​ls-100-luminance-meter/​|Minolta LS100]] | {{:​mgl:​ls100.jpg|}} | | Measures only luminance. Need to also buy [[http://​www.shopkmsa.com/​index.php?​p=product&​id=219&​parent=23|LSA-15 Cable]] which adapts the output to serial. | +| [[http://​sensing.konicaminolta.us/​products/​ls-100-luminance-meter/​|Minolta LS100]] | {{:​mgl:​ls100.jpg|}} | | Measures only luminance. Need to also buy LSA-15 Cable which adapts the output to serial. | 
-| [[http://​sensing.konicaminolta.us/​products/​cs-100-luminance-and-color-meter/​|Minolta CS100a]] | {{:​mgl:​cs_100a_top.jpg|}} | [[http://​www.konicaminolta.com/​instruments/​download/​instruction_manual/​display/​pdf/​cs-100a_instruction_eng.pdf|Instruction manual]] {{:​gruprivate:​cs-100a_communication_manual.pdf|Communication manual}} | Measures luminance and chrominance. Need to also buy [[http://​www.shopkmsa.com/​index.php?​p=product&​id=219&​parent=23|LSA-15 Cable]] which adapts the output to serial.|+| [[http://​sensing.konicaminolta.us/​products/​cs-100-luminance-and-color-meter/​|Minolta CS100a]] | {{:​mgl:​cs_100a_top.jpg|}} | [[http://​www.konicaminolta.com/​instruments/​download/​instruction_manual/​display/​pdf/​cs-100a_instruction_eng.pdf|Instruction manual]] {{:​gruprivate:​cs-100a_communication_manual.pdf|Communication manual}} | Measures luminance and chrominance. Need to also buy LSA-15 Cable which adapts the output to serial.|
  
 Our code may work with different models, but we have only tested the above listed models. If you want to use another photometer you can input the readings manually or consider writing a few lines of code in moncalib to support your photometer type. Our code may work with different models, but we have only tested the above listed models. If you want to use another photometer you can input the readings manually or consider writing a few lines of code in moncalib to support your photometer type.
  
-Note that there are some commercially available devices to calibrate monitor screens which create color profiling information ​(e.g. [[http://​usa.gretagmacbethstore.com/​index.cfm/​act/​Catalog.cfm/​catalogid/​1861/​Subcategory/​Eye-One%20Solutions/​category/​Eye-One/​browse/​null/​MenuGroup/​_Menu%20USA%20New/​desc/​Eye-One%20Display%202.htm|[5]]] [[http://​www.xritephoto.com/​product/​optixxr/​|[6]]] [[http://​www.colorvision.com/​|[7]]]. We have tested one of these called Spyder2Pro which allows you to linearize the monitor output but found that is not yet suitable for psychophysics purposes. The calibration program crashes when you use the default settings to linearize the monitor (an email to the tech support confirmed this is a bug in their software). Using advanced settings it worked but it could only test luminance at 5 output levels. The linearization that it achieved was not accurate enough when tested with the PR650 (it looked like they are doing some sort of spline fit of the points and the luminance as a function of monitor output level looked like a wavy line around the ideal).+Note that there are some commercially available devices to calibrate monitor screens which create color profiling information. We have tested one of these called Spyder2Pro which allows you to linearize the monitor output but found that is not yet suitable for psychophysics purposes. The calibration program crashes when you use the default settings to linearize the monitor (an email to the tech support confirmed this is a bug in their software). Using advanced settings it worked but it could only test luminance at 5 output levels. The linearization that it achieved was not accurate enough when tested with the PR650 (it looked like they are doing some sort of spline fit of the points and the luminance as a function of monitor output level looked like a wavy line around the ideal).
  
 ====== Serial device hardware ====== ====== Serial device hardware ======
Line 40: Line 40:
  
 ^ USB/Serial device ^ Image ^Driver version ^Comments ^ ^ USB/Serial device ^ Image ^Driver version ^Comments ^
-| [[http://​plugable.com/​products/​pl2303-db9|Plugable USB to RS-232 DB9 Serial Adapter]] | {{:​mgl:​plugable.jpg|}}| [[http://​plugable.com/​drivers/​prolific|Prolific driver 1.5.1]] | Works with the Topcon but **not** ​with the Minolta. This seems to be some issue with the driver ​not handling 7 bit serial communication properly (it for instance returns values ​with the high bit set when they should be 0). +| [[http://​plugable.com/​products/​pl2303-db9|Plugable USB to RS-232 DB9 Serial Adapter]] | {{:​mgl:​plugable.jpg|}}| [[http://​plugable.com/​drivers/​prolific|Prolific driver 1.5.1]] ​[[https://​www.prolific.com.tw/​admin/​Technology/​GetFile.ashx?​fileID=1509 ​Prolific driver, compatible ​with Sonoma]] | Update: works with Minolta ​CS100a as well, with the right driver. Works with the Topcon ​
-| [[http://​www.tripplite.com/​high-speed-usb-to-serial-adapter-keyspan~USA19HS/​|Keyspan High-Speed USB to Serial Adapter USA-19HS]] | {{:​{{:​mgl:​keyspan.jpg|}} | [[http://www.tripplite.com/​shared/software/​Driver/​Driver%20for%20USA-19HS_v2.6.4%20(Mac%20OS%20X%2010.6.x%20to%2010.8.x).zip +| [[http://​www.tripplite.com/​high-speed-usb-to-serial-adapter-keyspan~USA19HS/​|Keyspan High-Speed USB to Serial Adapter USA-19HS]] | {{:​{{:​mgl:​keyspan.jpg|}} | [[https://assets.tripplite.com/​drivers/usa-19hs-driver-v4-mac-os-x-10.9-10.11.zip |Mac OS X 10.9.x to 10.11.x Version 2.6 ]]{{:​gru:​keyspanusa_10.9_10.10_v4_signed.pkg.zip|Try this if that link is broken ​}} [[https://​www.tripplite.com/​support/​downloads/​|or look for '​USA-19HS' ​here]] | Works with Minolta CS100a. We used to use other versions of this device Keyspan USA-28 which worked with PR650 and a white translucent Keyspan USA-28X B which did **not** work. The Keyspan USA website does not yet have support for OS Sonoma. ​|
-|Mac OS X 10.6.x to 10.8.x Version 2.6]] [[:​gru:​keyspanusa_10.9_10.10_v4_signed.pkg.zip|Try this if that link is broken]] [[https://​www.tripplite.com/​support/​downloads/​type/​9/​tab/​2|Second backup link - search ​for '​USA-19HS'​]] | Works with Minolta CS100a. We used to use other versions of this device Keyspan USA-28 which worked with PR650 and a white translucent Keyspan USA-28X B which did **not** work |+
  
 Typically you can just connect the USB/Serial device to the Serial cable of the photometer, but for the Topcon you will need a nullmodem connector between the two (this swaps the read/write lines for communication). It looks like this (remember this should **only** be necessary for Topcon). Typically you can just connect the USB/Serial device to the Serial cable of the photometer, but for the Topcon you will need a nullmodem connector between the two (this swaps the read/write lines for communication). It looks like this (remember this should **only** be necessary for Topcon).
Line 167: Line 166:
  
 Basically there is about 2-3 secs time window you should press '​return'​ to get to this state. Basically there is about 2-3 secs time window you should press '​return'​ to get to this state.
 +
 +==== Notes on PR650 ====
 +Over the years, we've run into a few issues calibrating with the PR650. While it's the best photometer we have, it can be quite finicky and frustrating. Here are some things to keep in mind and to try when things go wrong.
 +
 +  *  Before each test measurement,​ or a run of the calibration,​ you probably need to unplug/​replug the photometer and power cycle it. Otherwise, the "CMD B" interface might not pop up. If you are having trouble getting CMD B, unplug, replug, and power cycle.
 +  * Weak light signal error: For some reason, the PR650, crown jewel of the photometer world, doesn'​t do a very good job making measurements in low light conditions. When the luminance is very low (e.g. at the beginning of the calibration when the screen starts off as black), it will give you an error that reads "Weak light signal"​ followed by a luminance value. That luminance value is a lie: it is made up, and when running moncalib, the program will treat it as an error and be unable to continue iterating through different luminances. If you are running into this issue, run moncalib with the flag "​fastSearch=1"​. At the beginning of the calibration,​ this will find the lowest luminance at which the photometer is able to make a legitimate measurement,​ and then calibrate with that as the lowest point. This may or may not be a problem for running stimuli with very low contrast - unclear at this point (12/2023).
 +
  
 ===== Actual calibration ===== ===== Actual calibration =====
Line 221: Line 227:
  
 The most important field of calib is the table field which holds the inverse lookup table to linearize the monitor. The most important field of calib is the table field which holds the inverse lookup table to linearize the monitor.
 +
 +===== Debugging =====
 +
 +  - For some reason, there are runs in which the gamma table doesn'​t change during the gamma measurement. I have found that rerunning moncalib, or waiting longer between the gammatable change and the photometer measurement (moncalib around L248) seems to alleviate this problem. ​