-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathmicaREADME.txt
executable file
·156 lines (117 loc) · 7.25 KB
/
micaREADME.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
__________MULTISPECTRAL IMAGE CALIBRATION AND ANALYSIS TOOLBOX________________
>>>>>>>>>>>> PLEASE VISIT WWW.EMPIRICALIMAGING.COM <<<<<<<<<<<<<<<<<
www.empiricalimaging.com hosts all the user guides, videos and forum.
This toolbox was written by Jolyon Troscianko 2013-2019, funded by BBSRC grants
to Martin Stevens and NERC fellowship to Jolyon Troscianko.
We release our code with a Creative Commons (BY) license. Licensees may copy,
distribute, display and perform the work and make derivative works based on it
only if they give credit by citing the relevatn papers:
Troscianko, J. & Stevens, M. (2015), Methods in Ecology & Evolution.
The QCPA framework component was a collaboration with these co-authors:
Cedric P. van den Berg, Jolyon Troscianko, John A. Endler, N. Justin Marshall,
Karen L. Cheney (2019). Quantitative Colour Pattern Analysis (QCPA): A Comprehensive
Framework for the Analysis of Colour Patterns in Nature
DCRAW is written by David Coffin, and we include a version of DCRAW with the
toolbox in line with the license for DCRAW.
Further credit should be given to the sources of the spectrum database:
Arnold, S.E., Faruq, S., Savolainen, V., McOwan, P.W., and Chittka, L. (2010).
FReD: the floral reflectance database—a web portal for analyses of flower colour.
PloS One 5, e14287.
And spectral sensitivity curves for various species.
The DOI for the QCPA GitHub release is:
DOI 10.5281/zenodo.3517897
https://zenodo.org/badge/latestdoi/200011243
Introduction:
~~~~~~~~~~~~~~~~
Digital cameras can be powerful tools for measuring colours and patterns in a
huge range of disciplines. However, in normal 'uncalibrated' digital photographs
the pixel values do not scale linearly with the amount of light measured by the
sensor. This means that pixel values cannot be reliably compared between
different photos or even regions within the same photo unless the images are
calibrated to be linear and have any lighting changes controlled for. Some
scientists are aware of these issues, but lack convenient, user-friendly software
to work with calibrated images, while many others continue to measure uncalibrated
images. We have developed a toolbox that can calibrate images using many common
consumer digital cameras, and for some cameras the images can be converted to
“animal vision”, to measure how the scene might look to non-humans. Many animals
can see down into the ultraviolet (UV) spectrum, such as most insects, birds,
reptiles, amphibians, some fish and some mammals, so it is important to measure
UV when working with these animals. Our toolbox can combine photographs taken
through multiple colour filters, for example allowing you to combine normal
photographs with UV photographs and convert to animal vision across their whole
range of sensitivities.
Installation:
~~~~~~~~~~~~~~~~
-This toolbox requires a working installation of ImageJ.
-Place these files in your imagej/plugins folder.
-See the user guide for more information.
_________________MULTISPECTRAL IMAGING TOOLBOX CHANGE-LOG____________________
______________________________________________________________________________
--------------------------------15/3/2019 -----------------------------------
Update to version 2.
This is a massive upgrade, with completely overhauled functions and the entire
QCPA analysis added.
See www.empiricalimaging.com for detailed information on this release (there's
too much to list here).
______________________________________________________________________________
--------------------------------20/10/2020 -----------------------------------
Big Update:
Switch to using LibRAW instead of DCRAW
Addition of affine transform image alignment
Switch to using more flexible mspec data flow between scripts
______________________________________________________________________________
--------------------------------26/9/2018 -----------------------------------
Big Update:
Addition of "AcuityView" for ImageJ
Addition of user-friendly GabRat edge disruption measurement tools
User-firedly basic pixel measurement tools improved (using "R" and "M" keys
after loading or generating an mspec image).
Non-linear and linear image support improvements. e.g. you can now specify that
the input image is already linear, or is an sRGB image. Be very wary of assuming
any image is truly sRGB though - in my experience almost no images conform to the
CIE's sRGB recommendaiton because camera dynamic ranges have improved since this
standard was created. If in doubt, try to make a custom linearisation model.
Bug fixes (due to changes in ImageJ v1.52)
Additional cameras and visual systems added
Due to the confusion caused by previous 16-bit pixel values, normalised images
are now on a reflectance scale (0-100%, though numbers outside this range are
supported as long as the sensor is not saturated), and cone-catch values are
now on a 0-1 scale. Old MSPEC images can be loaded and measured as usual, however
you will need to create new cone-mapping functions which work on the new scale!
______________________________________________________________________________
--------------------------------14/11/2016 -----------------------------------
Big update:
Support for non-linear images
The cone mapping model generation now uses the JAMA library to make the models
so no dependence on R.
______________________________________________________________________________
--------------------------------11/2/2015 -----------------------------------
Colour JND difference calculator added to go with pattern & lum measurements.
Lots of little bug fixes and neatenning of dialog boxes
--------------------------------5/1/2015 -----------------------------------
Bug fixed where importing slice labes had a limit of 4 grey standards.
--------------------------------19/12/2014 -----------------------------------
Patter & luminance distribution difference calculator fixed to work with new
output that produces multiple tables.
______________________________________________________________________________
--------------------------------4/12/2014 -----------------------------------
Added manual alignment option for when auto-align doesn't work reliably.
This was most common when images didn't have much detail for the alignment
to work with. In future it might be good to add manual scaling to this
function.
The options window for generating multispec images was too big for some
screens, so I've simplified it.
I've reduced the number of output options so that they're all 32-bit (people
shouldn't work with anything else), and alignment checking has been added.
The pseudo-uv output and visible output should make reviewing images and
selecting ROIs on dark images easier.
Image-changed flag rest on each multispectral image load, so the save image
dialog won't come up.
Bug fix in renaming RAW files.
______________________________________________________________________________
--------------------------------28/11/2014 -----------------------------------
Batch image analysis output changed from all being squeezed onto the same
big results table (with lots of zeros in the spaces), to separate results
tables for summary data, pattern spectra and luminance distributions. I still
need to add tools to analyse these results easily in one...
______________________________________________________________________________