~ubuntu-branches/ubuntu/trusty/psychtoolbox-3/trusty-proposed

« back to all changes in this revision

Viewing changes to Psychtoolbox/PsychRadiometric/PsychAnsiZ136MPE/Contents.m

  • Committer: Package Import Robot
  • Author(s): Yaroslav Halchenko
  • Date: 2013-11-19 23:34:50 UTC
  • mfrom: (3.1.4 experimental)
  • Revision ID: package-import@ubuntu.com-20131119233450-f7nf92vb8qavjmk8
Tags: 3.0.11.20131017.dfsg1-3
Upload to unsable since fresh glew has arrived to sid!

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
% Psychtoolbox:PsychAnsiZ136MPE.
 
2
%
 
3
% Partial and in progress implementation of Ansi Z136.1-2007 standard for computing
 
4
% maximum permissable exposure.
 
5
%
 
6
% *****************************************************************
 
7
% IMPORTANT:
 
8
%   a) Individuals using these routines must accept full responsibility 
 
9
%   for light exposures they implement. We recommend that values computed
 
10
%   with these routines be carefully checked against independent calculations.
 
11
%   We have done our best to follow the standard, but it is very complex and
 
12
%   there may be errors.
 
13
%
 
14
%   b) As of March, 2013, these routines are still very much a work
 
15
%   in progress and should thus be treated with special caution.  See
 
16
%   AnsiZ136MPEBasicTest and AnsiZ136MPEDeloriTest, both for test 
 
17
%   code, and for comments about points of uncertainty.
 
18
%
 
19
%   c) Particularly obscure to me at present is the limiting cone aperture
 
20
%   section described with an asterisk in Table 2 of the 2007 standard 
 
21
%   document.
 
22
%
 
23
%   d) The field's knowledge of safe light levels is evolving, and it is important
 
24
%   to keep abreast of current research and not to rely soley on the
 
25
%   Ansi standard.  In particular, note that there
 
26
%   are reports of disrubption at light levels below the limits specified
 
27
%   in the Ansi 2007 stanard. See for example:
 
28
%     Morgan et al., (2008), IOVS, 49, 3715-3729.
 
29
%     Morgan et al., (2009), IOVS, 50, 6015-6022.
 
30
%     Hunter et al., (2012), Prog. Ret. Eye. Res., 31, 28-42.
 
31
%
 
32
%   e) Apparently a new version of the Ansi Z136 standard is forthcoming,
 
33
%   but I do not have information as to what changed.
 
34
%
 
35
%   f) The Z136 standard is for laser light, which is coherent and monochromatic.
 
36
%   Different standards apply for broadband lights.  Two relevant references are:
 
37
%     ISO 15004-2:2007, Ophthalmic instruments -- Fundamental requirements and
 
38
%     test methods -- Part 2: Light hazard protection.
 
39
%
 
40
%     ICNIRP (International Commission on Non-Ionizing Radiation Protection) Guidelines,
 
41
%     (1997), Guidelines on exposure to broad-band inchoherent optical radiation (0.38 to 3 uM),
 
42
%     Health Physics, 73, 539-554.
 
43
%   The second seems a little old, but is the most recent ICNIRP guideline for broadband
 
44
%   that I could easily locate.
 
45
%
 
46
%  - David Brainard, March 6, 2013.
 
47
% *****************************************************************
 
48
%
 
49
% REFERENCES.
 
50
%   Ansi Z136.1-2007.  The standard document. The more recent Ansi Z136.8-2012
 
51
%   refers back to the 2007 document for the MPE calculations.  But see
 
52
%   point d) in the notes above.
 
53
%
 
54
%   Delori et al., 2007, JOSA A, 24, 1250-1265.  Provides explanation
 
55
%   about many of the calculations in the 2000 version of the standard.
 
56
%
 
57
%   AnsiZ136MPEBasicTest - Test the suite of routines.  Generates many figures that should match those in the standard.
 
58
%   AnsiZ136MPEComputeCa - Compute constant Ca, Table 6
 
59
%   AnsiZ136MPEComputeCb - Compute constant Cb, Table 6
 
60
%   AnsiZ136MPEComputeCc - Compute constant Cc, Table 6
 
61
%   AnsiZ136MPEComputeCe - Compute constant Ce, Table 6
 
62
%   AnsiZ136MPEComputeExtendedSourceLimit - Compute overall MPE limit for extended sources, Table 5b
 
63
%   AnsiZ136MPEComputeExtendedSourcePhotochemicalLimit - Compute photochemical MPE for extended sources, Table 5b
 
64
%   AnsiZ136MPEComputeLimitingConeAngle - Compute limiting cone angle, Table 6
 
65
%   AnsiZ136MPEComputeT2 - Compute constant T2, Table 6
 
66
%   AnsiZ136MPEDeloriTest - Tests our computations against those from Delori's spreadsheet.
 
67
 
 
68
% Copyright (c) 2013 by David Brainard