source: trunk/src/geometry_calib.m @ 755

Last change on this file since 755 was 755, checked in by sommeria, 10 years ago
File size: 59.0 KB
Line 
1%'geometry_calib': associated to the GUI geometry_calib to perform geometric calibration from a set of reference points
2%------------------------------------------------------------------------
3% function hgeometry_calib = geometry_calib(inputfile,pos)
4%
5%OUTPUT:
6% hgeometry_calib=current handles of the GUI geometry_calib.fig
7%
8%INPUT:
9% inputfile: (optional) name of an xml file containing coordinates of reference points
10% pos: (optional) 4 element vector setting the 'Position' of the GUI
11%
12%A%AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
13%  Copyright Joel Sommeria, 2008, LEGI / CNRS-UJF-INPG, sommeria@coriolis-legi.org.
14%AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
15%     This file is part of the toolbox UVMAT.
16%
17%     UVMAT is free software; you can redistribute it and/or modify
18%     it under the terms of the GNU General Public License as published by
19%     the Free Software Foundation; either version 2 of the License, or
20%     (at your option) any later version.
21%
22%     UVMAT is distributed in the hope that it will be useful,
23%     but WITHOUT ANY WARRANTY; without even the implied warranty of
24%     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
25%     GNU General Public License (file UVMAT/COPYING.txt) for more details.
26%AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
27
28function varargout = geometry_calib(varargin)
29% GEOMETRY_CALIB M-file for geometry_calib.fig
30%      GEOMETRY_CALIB, by itself, creates a MenuCoord GEOMETRY_CALIB or raises the existing
31%      singleton*.
32%
33%      H = GEOMETRY_CALIB returns the handle to a MenuCoord GEOMETRY_CALIB or the handle to
34%      the existing singleton*.
35%
36%      GEOMETRY_CALIB('CALLBACK',hObject,eventData,handles,...) calls the local
37%      function named CALLBACK in GEOMETRY_CALIB.M with the given input arguments.
38%
39%      GEOMETRY_CALIB('Property','Value',...) creates a MenuCoord GEOMETRY_CALIB or raises the
40%      existing singleton*.  Starting from the left, property value pairs are
41%      applied to the GUI before geometry_calib_OpeningFunction gets called.  An
42%      unrecognized property name or invalid value makes property application
43%      stop.  All inputs are passed to geometry_calib_OpeningFcn via varargin.
44%
45%      *See GUI Options on GUIDE's Tools menu.  Choose "GUI allows only one
46%      instance to run (singleton)".
47%
48% See also: GUIDE, GUIDATA, GUIHANDLES
49
50% Edit the above text to modify the response to help geometry_calib
51
52% Last Modified by GUIDE v2.5 11-Apr-2014 23:10:57
53
54% Begin initialization code - DO NOT edit
55gui_Singleton = 1;
56gui_State = struct('gui_Name',       mfilename, ...
57                   'gui_Singleton',  gui_Singleton, ...
58                   'gui_OpeningFcn', @geometry_calib_OpeningFcn, ...
59                   'gui_OutputFcn',  @geometry_calib_OutputFcn, ...
60                   'gui_LayoutFcn',  [] , ...
61                   'gui_Callback',   []);
62if nargin
63   [pp,ff]=fileparts(which(varargin{1})); % name of the input file
64   if strcmp(ff,mfilename)% if we are activating a sub-function of geometry_calib
65   % ~isempty(regexp(varargin{1},'_Callback','once'))
66    gui_State.gui_Callback = str2func(varargin{1});
67   end
68end
69
70if nargout
71    [varargout{1:nargout}] = gui_mainfcn(gui_State, varargin{:});
72else
73    gui_mainfcn(gui_State, varargin{:});
74end
75% End initialization code - DO NOT edit
76
77
78% --- Executes just before geometry_calib is made visible.
79%INPUT:
80%handles: handles of the geometry_calib interface elements
81% PlotHandles: set of handles of the elements contolling the plotting
82% parameters on the uvmat interface (obtained by 'get_plot_handle.m')
83%------------------------------------------------------------------------
84function geometry_calib_OpeningFcn(hObject, eventdata, handles,inputfile)
85%------------------------------------------------------------------------
86% Choose default command line output for geometry_calib
87
88handles.output = hObject;
89
90% Update handles structure
91guidata(hObject, handles);
92set(hObject,'DeleteFcn',{@closefcn})%
93%set(hObject,'WindowButtonDownFcn',{'mouse_alt_gui',handles}) % allows mouse action with right button (zoom for uicontrol display)
94
95%% position
96set(0,'Unit','pixels')
97ScreenSize=get(0,'ScreenSize');% get the size of the screen, to put the fig on the upper right
98Left=ScreenSize(3)- 460; %right edge close to the right, with margin=40 (GUI width=420 px)
99if ScreenSize(4)>920
100    Height=840;%default height of the GUI
101    Bottom=ScreenSize(4)-Height-40; %put fig at top right
102else
103    Height=ScreenSize(4)-80;
104    Bottom=40; % GUI lies o the screen bottom (with margin =40)
105end
106set(handles.calib_type,'Position',[1 Height-40 194 30])%  rank 1
107set(handles.APPLY,'Position',[197 Height-40 110 30])%  rank 1
108set(handles.REPLICATE,'Position',[309 Height-40 110 30])%  rank 1
109set(handles.Intrinsic,'Position',[1 Height-40-2-92 418 92])%  rank 2
110set(handles.Extrinsic,'Position',[1 Height-40-4-92-75 418 75])%  rank 3
111set(handles.PointLists,'Position',[1 Height-40-6-92-75-117 418 117]) %  rank 4
112set(handles.CheckEnableMouse,'Position',[3 Height-40-8-92-75-117-30 180 30])%  rank 5
113set(handles.PLOT,'Position',[3 Height-394 120 30])%  rank 6
114set(handles.Copy,'Position',[151 Height-394 120 30])%  rank 6
115set(handles.CLEAR_PTS,'Position',[297 Height-394 120 30])%  rank 6
116set(handles.ClearLine,'Position',[297 Height-364 120 30])%  rank 6
117set(handles.CoordLine,'Position',[177 Height-364 120 30])%  rank 6
118set(handles.phys_title,'Position',[38 Height-426 125 20])%  rank 7
119set(handles.CoordUnit,'Position',[151 Height-426 120 30])%  rank 7
120set(handles.px_title,'Position',[272 Height-426 125 20])%  rank 7
121set(handles.ListCoord,'Position',[1 20 418 Height-446])% rank 8
122set(handles.geometry_calib,'Position',[Left Bottom 420 Height])
123
124%set menu of calibration options
125set(handles.calib_type,'String',{'rescale';'linear';'3D_linear';'3D_quadr';'3D_extrinsic'})
126if exist('inputfile','var')&& ~isempty(inputfile)
127%     struct.XmlInputFile=inputfile;
128    [RootPath,SubDir,RootFile,tild,tild,tild,tild,FileExt]=fileparts_uvmat(inputfile);
129    struct.XmlInputFile=find_imadoc(RootPath,SubDir,RootFile,FileExt);
130%     if ~strcmp(FileExt,'.xml')
131%         inputfile=fullfile(RootPath,[SubDir '.xml']);%xml file corresponding to the input file
132%         if ~exist(inputfile,'file')% case of civ files , removes the extension for subdir
133%             inputfile=fullfile(RootPath,[regexprep(SubDir,'\..+$','') '.xml']);
134%             if ~exist(inputfile,'file')
135%                 inputfile=[fullfile(RootPath,SubDir,RootFile) '.xml'];%old convention
136%                 if ~exist(inputfile,'file')
137%                     inputfile='';
138%                 end
139%             end
140%         end
141%     end
142    set(handles.ListCoord,'Data',[])
143    if exist(struct.XmlInputFile,'file')
144        Heading=loadfile(handles,struct.XmlInputFile);% load data from the xml file and fill the GUI
145        if isfield(Heading,'Campaign')&& ischar(Heading.Campaign)
146            struct.Campaign=Heading.Campaign;
147        end
148    end   
149    set(hObject,'UserData',struct)
150end
151
152%------------------------------------------------------------------------
153% --- Outputs from this function are returned to the command line.
154function varargout = geometry_calib_OutputFcn(~, eventdata, handles)
155%------------------------------------------------------------------------
156% Get default command line output from handles structure
157varargout{1} = handles.output;
158varargout{2}=handles;
159%
160%------------------------------------------------------------------------
161% executed when closing: set the parent interface button to value 0
162function closefcn(gcbo,eventdata)
163%------------------------------------------------------------------------
164huvmat=findobj(allchild(0),'Name','uvmat');
165if ~isempty(huvmat)
166    handles=guidata(huvmat);
167    set(handles.MenuCalib,'Checked','off')
168    hobject=findobj(handles.PlotAxes,'tag','calib_points');
169    if ~isempty(hobject)
170        delete(hobject)
171    end
172    hobject=findobj(handles.PlotAxes,'tag','calib_marker');
173    if ~isempty(hobject)
174        delete(hobject)
175    end   
176end
177
178%------------------------------------------------------------------------
179% --- Executes on button press APPLY (used to launch the calibration).
180function APPLY_Callback(hObject, eventdata, handles)
181%------------------------------------------------------------------------
182%% look for the GUI uvmat and check for an image as input
183set(handles.APPLY,'BackgroundColor',[1 1 0])
184huvmat=findobj(allchild(0),'Name','uvmat');
185hhuvmat=guidata(huvmat);%handles of elements in the GUI uvmat
186
187RootPath='';
188if ~isempty(hhuvmat.RootPath)&& ~isempty(hhuvmat.RootFile)
189    RootPath=get(hhuvmat.RootPath,'String');
190    SubDirBase=regexprep(get(hhuvmat.SubDir,'String'),'\..+$','');
191    outputfile=[fullfile(RootPath,SubDirBase) '.xml'];%xml file associated with the currently displayed image
192else
193    question={'save the calibration data and point coordinates in'};
194    def={fullfile(RootPath,'ObjectCalib.xml')};
195    options.Resize='on';
196    answer=inputdlg(question,'',1,def,options);
197    outputfile=answer{1};
198end
199[GeometryCalib,index]=calibrate(handles,hhuvmat);% apply calibration
200
201if isempty(GeometryCalib) % if calibration cancelled
202    set(handles.APPLY,'BackgroundColor',[1 0 1])
203else   % if calibration confirmed
204   
205    %% copy the xml file from the old location if appropriate, then update with the calibration parameters
206    if ~exist(outputfile,'file') && ~isempty(SubDirBase)
207        oldxml=[fullfile(RootPath,SubDirBase,get(hhuvmat.RootFile,'String')) '.xml'];
208        if exist(oldxml,'file')
209            [success,message]=copyfile(oldxml,outputfile);%copy the old xml file to a new one with the new convention
210        end
211    end
212    errormsg=update_imadoc(GeometryCalib,outputfile,'GeometryCalib');% introduce the calibration data in the xml file
213    if ~strcmp(errormsg,'')
214        msgbox_uvmat('ERROR',errormsg);
215    end
216   
217    %% display image with new calibration in the currently opened uvmat interface
218    FieldList=get(hhuvmat.FieldName,'String');
219    val=get(hhuvmat.FieldName,'Value');
220    if strcmp(FieldList{val},'image')
221        set(hhuvmat.CheckFixLimits,'Value',0)% put FixedLimits option to 'off' to plot the whole image
222        UserData=get(handles.geometry_calib,'UserData');
223        UserData.XmlInputFile=outputfile;%save the current xml file name
224        set(handles.geometry_calib,'UserData',UserData)
225        uvmat('InputFileREFRESH_Callback',hObject,eventdata,hhuvmat); %file input with xml reading  in uvmat, show the image in phys coordinates
226        PLOT_Callback(hObject, eventdata, handles)
227        set(handles.CoordLine,'string',num2str(index))
228        Coord=get(handles.ListCoord,'Data');
229        update_calib_marker(Coord(index,:)); %indicate the point with max deviations from phys coord to calibration
230        figure(handles.geometry_calib)% put the GUI geometry_calib in front
231        set(handles.APPLY,'BackgroundColor',[1 0 0]) % set APPLY button to red color
232    else
233        msgbox_uvmat('WARNING','open the image to see the effect of the new calibration')
234    end
235end
236
237%------------------------------------------------------------------------
238% --- Executes on button press in REPLICATE
239function REPLICATE_Callback(hObject, eventdata, handles)
240%------------------------------------------------------------------------
241
242%% look for the GUI uvmat and check for an image as input
243huvmat=findobj(allchild(0),'Name','uvmat');
244hhuvmat=guidata(huvmat);%handles of elements in the GUI uvmat
245GeometryCalib=calibrate(handles,hhuvmat);% apply calibration
246
247%% open the GUI browse_data
248CalibData=get(handles.geometry_calib,'UserData');%read the calibration image source on the interface userdata
249if isfield(CalibData,'XmlInputFile')
250    InputDir=fileparts(fileparts(CalibData.XmlInputFile));
251end
252answer=msgbox_uvmat('INPUT_TXT','Campaign to calibrate?',InputDir);
253if strcmp(answer,'Cancel')
254    return
255end
256OutPut=browse_data(answer);
257nbcalib=0;
258for ilist=1:numel(OutPut.Experiment)
259    SubDirBase=regexprep(OutPut.DataSeries{1},'\..+$','');
260    XmlName=fullfile(OutPut.Campaign,OutPut.Experiment{ilist},[SubDirBase '.xml']);
261    % copy the xml file from the old location if appropriate, then update with the calibration parameters
262    if ~exist(XmlName,'file') && ~isempty(SubDirBase)
263        oldxml=fullfile(OutPut.Campaign,OutPut.Experiment{ilist},SubDirBase,[get(hhuvmat.RootFile,'String') '.xml']);
264        if exist(oldxml,'file')
265            [success,message]=copyfile(oldxml,XmlName);%copy the old xml file to a new one with the new convention
266        end
267    end
268    errormsg=update_imadoc(GeometryCalib,XmlName,'GeometryCalib');% introduce the calibration data in the xml file
269    if ~strcmp(errormsg,'')
270        msgbox_uvmat('ERROR',errormsg);
271    else
272        display([XmlName ' updated with calibration parameters'])
273        nbcalib=nbcalib+1;
274    end
275end
276msgbox_uvmat('CONFIMATION',[SubDirBase ' calibrated for ' num2str(nbcalib) ' experiments']);
277
278%------------------------------------------------------------------------
279% --- activate calibration and store parameters in ouputfile .
280function [GeometryCalib,index]=calibrate(handles,hhuvmat)
281%------------------------------------------------------------------------
282set(handles.CheckEnableMouse,'Value',0)% desactivate mouse (to avoid spurious creation of new points)
283%% read the current calibration points
284index=[];
285Coord=get(handles.ListCoord,'Data');
286Coord(:,6)=[];
287% apply the calibration, whose type is selected in  handles.calib_type
288GeometryCalib=[];
289if ~isempty(Coord)
290    calib_cell=get(handles.calib_type,'String');
291    val=get(handles.calib_type,'Value');
292    GeometryCalib=feval(['calib_' calib_cell{val}],Coord,handles);
293else
294    msgbox_uvmat('ERROR','No calibration points, abort')
295end
296if isempty(GeometryCalib)
297    return
298end
299Z_plane=[];
300if ~isempty(Coord)
301    %check error
302    X=Coord(:,1);
303    Y=Coord(:,2);
304    Z=Coord(:,3);
305    x_ima=Coord(:,4);
306    y_ima=Coord(:,5);
307    [Xpoints,Ypoints]=px_XYZ(GeometryCalib,X,Y,Z);
308    GeometryCalib.ErrorRms(1)=sqrt(mean((Xpoints-x_ima).*(Xpoints-x_ima)));
309    [GeometryCalib.ErrorMax(1),index(1)]=max(abs(Xpoints-x_ima));
310    GeometryCalib.ErrorRms(2)=sqrt(mean((Ypoints-y_ima).*(Ypoints-y_ima)));
311    [GeometryCalib.ErrorMax(2),index(2)]=max(abs(Ypoints-y_ima));
312    [tild,ind_dim]=max(GeometryCalib.ErrorMax);
313    index=index(ind_dim);
314    %set the Z position of the reference plane used for calibration
315    if isequal(max(Z),min(Z))%Z constant
316        Z_plane=Z(1);
317        GeometryCalib.NbSlice=1;
318        GeometryCalib.SliceCoord=[0 0 Z_plane];
319    end
320end
321%set the coordinate unit
322unitlist=get(handles.CoordUnit,'String');
323unit=unitlist{get(handles.CoordUnit,'value')};
324GeometryCalib.CoordUnit=unit;
325%record the points
326GeometryCalib.SourceCalib.PointCoord=Coord;
327display_intrinsic(GeometryCalib,handles)%display calibration intrinsic parameters
328
329% Display extrinsinc parameters (rotation and translation of camera with  respect to the phys coordiantes)
330set(handles.Tx,'String',num2str(GeometryCalib.Tx_Ty_Tz(1),4))
331set(handles.Ty,'String',num2str(GeometryCalib.Tx_Ty_Tz(2),4))
332set(handles.Tz,'String',num2str(GeometryCalib.Tx_Ty_Tz(3),4))
333set(handles.Phi,'String',num2str(GeometryCalib.omc(1),4))
334set(handles.Theta,'String',num2str(GeometryCalib.omc(2),4))
335set(handles.Psi,'String',num2str(GeometryCalib.omc(3),4))
336
337%% store the calibration data, by default in the xml file of the currently displayed image
338UvData=get(hhuvmat.uvmat,'UserData');
339% NbSlice_j=1;%default
340% ZStart=Z_plane;
341% ZEnd=Z_plane;
342% volume_scan='n';
343% if isfield(UvData,'XmlData')
344%     if isfield(UvData.XmlData,'TranslationMotor')
345%         NbSlice_j=UvData.XmlData.TranslationMotor.Nbslice;
346%         ZStart=UvData.XmlData.TranslationMotor.ZStart/10;
347%         ZEnd=UvData.XmlData.TranslationMotor.ZEnd/10;
348%         volume_scan='y';
349%     end
350% end
351
352answer=msgbox_uvmat('INPUT_Y-N',{'store calibration data';...
353    ['Error rms (along x,y)=' num2str(GeometryCalib.ErrorRms) ' pixels'];...
354    ['Error max (along x,y)=' num2str(GeometryCalib.ErrorMax) ' pixels']});
355
356%% get plane position(s)
357if ~strcmp(answer,'Yes')
358    GeometryCalib=[];
359    index=1;
360    return
361end
362if strcmp(calib_cell{val}(1:2),'3D')%set the plane position for 3D (projection) calibration
363    msgbox_uvmat('CONFIRMATION',{['The current image series is assumed by default in the plane of the calib points z=' num2str(Z_plane) ] ; 'can be modified by MenuSetSlice in the upper bar menu of uvmat'})
364%     input_key={'Z (first position)','Z (last position)','Z (water surface)', 'refractive index','NbSlice','volume scan (y/n)','tilt angle y axis','tilt angle x axis'};
365%     input_val=[{num2str(ZEnd)} {num2str(ZStart)} {num2str(ZStart)} {'1.333'} num2str(NbSlice_j) {volume_scan} {'0'} {'0'}];
366%     answer=inputdlg(input_key,'slice position(s)',ones(1,8), input_val,'on');
367%     GeometryCalib.NbSlice=str2double(answer{5});
368%     GeometryCalib.VolumeScan=answer{6};
369%     if isempty(answer)
370%         Z_plane=0; %default
371%     else
372%         Z_plane=linspace(str2double(answer{1}),str2double(answer{2}),GeometryCalib.NbSlice);
373%     end
374     GeometryCalib.SliceCoord=Z_plane'*[0 0 1];
375%     GeometryCalib.SliceAngle(:,3)=0;
376%     GeometryCalib.SliceAngle(:,2)=str2double(answer{7})*ones(GeometryCalib.NbSlice,1);%rotation around y axis (to generalise)
377%     GeometryCalib.SliceAngle(:,1)=str2double(answer{8})*ones(GeometryCalib.NbSlice,1);%rotation around x axis (to generalise)
378%     GeometryCalib.InterfaceCoord=[0 0 str2double(answer{3})];
379%     GeometryCalib.RefractionIndex=str2double(answer{4});
380end
381
382%------------------------------------------------------------------------
383% --- determine the parameters for a calibration by an affine function (rescaling and offset, no rotation)
384function GeometryCalib=calib_rescale(Coord,handles)
385%------------------------------------------------------------------------
386X=Coord(:,1);
387Y=Coord(:,2);% Z not used
388x_ima=Coord(:,4);
389y_ima=Coord(:,5);
390[px]=polyfit(X,x_ima,1);
391[py]=polyfit(Y,y_ima,1);
392% T_x=px(2);
393% T_y=py(2);
394GeometryCalib.CalibrationType='rescale';
395GeometryCalib.fx_fy=[px(1) py(1)];%.fx_fy corresponds to pxcm along x and y
396GeometryCalib.CoordUnit=[];% default value, to be updated by the calling function
397GeometryCalib.Tx_Ty_Tz=[px(2)/px(1) py(2)/py(1) 1];
398GeometryCalib.omc=[0 0 0];
399
400%------------------------------------------------------------------------
401% --- determine the parameters for a calibration by a linear transform matrix (rescale and rotation)
402function GeometryCalib=calib_linear(Coord,handles)
403%------------------------------------------------------------------------
404X=Coord(:,1);
405Y=Coord(:,2);% Z not used
406x_ima=Coord(:,4);
407y_ima=Coord(:,5);
408XY_mat=[ones(size(X)) X Y];
409a_X1=XY_mat\x_ima; %transformation matrix for X
410a_Y1=XY_mat\y_ima;%transformation matrix for X
411R=[a_X1(2),a_X1(3);a_Y1(2),a_Y1(3)];
412epsilon=sign(det(R));
413norm=abs(det(R));
414GeometryCalib.CalibrationType='linear';
415if (a_X1(2)/a_Y1(3))>0
416    GeometryCalib.fx_fy(1)=sqrt((a_X1(2)/a_Y1(3))*norm);
417else
418    GeometryCalib.fx_fy(1)=-sqrt(-(a_X1(2)/a_Y1(3))*norm);
419end
420GeometryCalib.fx_fy(2)=(a_Y1(3)/a_X1(2))*GeometryCalib.fx_fy(1);
421GeometryCalib.CoordUnit=[];% default value, to be updated by the calling function
422GeometryCalib.Tx_Ty_Tz=[a_X1(1)/GeometryCalib.fx_fy(1) a_Y1(1)/GeometryCalib.fx_fy(2) 1];
423R(1,:)=R(1,:)/GeometryCalib.fx_fy(1);
424R(2,:)=R(2,:)/GeometryCalib.fx_fy(2);
425R=[R;[0 0]];
426GeometryCalib.R=[R [0;0;-epsilon]];
427GeometryCalib.omc=(180/pi)*[acos(GeometryCalib.R(1,1)) 0 0];
428
429%------------------------------------------------------------------------
430% --- determine the tsai parameters for a view normal to the grid plane
431% NOT USED
432function GeometryCalib=calib_normal(Coord,handles)
433%------------------------------------------------------------------------
434Calib.f1=str2num(get(handles.fx,'String'));
435Calib.f2=str2num(get(handles.fy,'String'));
436Calib.k=str2num(get(handles.kc,'String'));
437Calib.Cx=str2num(get(handles.Cx,'String'));
438Calib.Cy=str2num(get(handles.Cy,'String'));
439%default
440if isempty(Calib.f1)
441    Calib.f1=25/0.012;
442end
443if isempty(Calib.f2)
444    Calib.f2=25/0.012;
445end
446if isempty(Calib.k)
447    Calib.k=0;
448end
449if isempty(Calib.Cx)||isempty(Calib.Cy)
450    huvmat=findobj(allchild(0),'Tag','uvmat');
451    hhuvmat=guidata(huvmat);
452    Calib.Cx=str2num(get(hhuvmat.num_Npx,'String'))/2;
453    Calib.Cx=str2num(get(hhuvmat.num_Npy,'String'))/2;
454end   
455%tsai parameters
456Calib.dpx=0.012;%arbitrary
457Calib.dpy=0.012;
458Calib.sx=Calib.f1*Calib.dpx/(Calib.f2*Calib.dpy);
459Calib.f=Calib.f2*Calib.dpy;
460Calib.kappa1=Calib.k/(Calib.f*Calib.f);
461
462%initial guess
463X=Coord(:,1);
464Y=Coord(:,2);
465Zmean=mean(Coord(:,3));
466x_ima=Coord(:,4)-Calib.Cx;
467y_ima=Coord(:,5)-Calib.Cy;
468XY_mat=[ones(size(X)) X Y];
469a_X1=XY_mat\x_ima; %transformation matrix for X
470a_Y1=XY_mat\y_ima;%transformation matrix for Y
471R=[a_X1(2),a_X1(3),0;a_Y1(2),a_Y1(3),0;0,0,-1];% rotation+ z axis reversal (upward)
472norm=sqrt(det(-R));
473calib_param(1)=0;% quadratic distortion
474calib_param(2)=a_X1(1);
475calib_param(3)=a_Y1(1);
476calib_param(4)=Calib.f/(norm*Calib.dpx)-R(3,3)*Zmean;
477calib_param(5)=angle(a_X1(2)+1i*a_X1(3));
478display(['initial guess=' num2str(calib_param)])
479
480%optimise the parameters: minimisation of error
481calib_param = fminsearch(@(calib_param) error_calib(calib_param,Calib,Coord),calib_param);
482
483GeometryCalib.CalibrationType='tsai_normal';
484GeometryCalib.focal=Calib.f;
485GeometryCalib.dpx_dpy=[Calib.dpx Calib.dpy];
486GeometryCalib.Cx_Cy=[Calib.Cx Calib.Cy];
487GeometryCalib.sx=Calib.sx;
488GeometryCalib.kappa1=calib_param(1);
489GeometryCalib.CoordUnit=[];% default value, to be updated by the calling function
490GeometryCalib.Tx_Ty_Tz=[calib_param(2) calib_param(3) calib_param(4)];
491alpha=calib_param(5);
492GeometryCalib.R=[cos(alpha) sin(alpha) 0;-sin(alpha) cos(alpha) 0;0 0 -1];
493
494%------------------------------------------------------------------------
495function GeometryCalib=calib_3D_linear(Coord,handles)
496%------------------------------------------------------------------------
497path_uvmat=which('uvmat');% check the path detected for source file uvmat
498path_UVMAT=fileparts(path_uvmat); %path to UVMAT
499huvmat=findobj(allchild(0),'Tag','uvmat');
500hhuvmat=guidata(huvmat);
501coord_files=get(handles.ListCoordFiles,'String');
502if ischar(coord_files)
503    coord_files={coord_files};
504end
505if isempty(coord_files{1}) || isequal(coord_files,{''})
506    coord_files={};
507end
508%retrieve the calibration points stored in the files listed in the popup list ListCoordFiles
509x_1=Coord(:,4:5)';%px coordinates of the ref points
510if ~strcmp(get(hhuvmat.Scalar,'Visible'),'on')
511    msgbox_uvmat('ERROR','An image needs to be opened in uvmat for calibration')
512  return
513end
514nx=str2num(get(hhuvmat.num_Npx,'String'));
515ny=str2num(get(hhuvmat.num_Npy,'String'));
516x_1(2,:)=ny-x_1(2,:);%reverse the y image coordinates
517X_1=Coord(:,1:3)';%phys coordinates of the ref points
518n_ima=numel(coord_files)+1;
519if ~isempty(coord_files)
520    msgbox_uvmat('CONFIRMATION',['The xy coordinates of the calibration points in ' num2str(n_ima) ' planes will be used'])
521    for ifile=1:numel(coord_files)
522    t=xmltree(coord_files{ifile});
523    s=convert(t);%convert to matlab structure
524        if isfield(s,'GeometryCalib')
525            if isfield(s.GeometryCalib,'SourceCalib')
526                if isfield(s.GeometryCalib.SourceCalib,'PointCoord')
527                PointCoord=s.GeometryCalib.SourceCalib.PointCoord;
528                Coord_file=zeros(length(PointCoord),5);%default
529                for i=1:length(PointCoord)
530                    line=str2num(PointCoord{i});
531                    Coord_file(i,4:5)=line(4:5);%px x
532                    Coord_file(i,1:3)=line(1:3);%phys x
533                end
534                eval(['x_' num2str(ifile+1) '=Coord_file(:,4:5)'';']);
535                eval(['x_' num2str(ifile+1) '(2,:)=ny-x_' num2str(ifile+1) '(2,:);' ]);
536                eval(['X_' num2str(ifile+1) '=Coord_file(:,1:3)'';']);
537                end
538            end
539        end
540    end
541end
542n_ima=numel(coord_files)+1;
543est_dist=[0;0;0;0;0];
544est_aspect_ratio=0;
545est_fc=[1;1];
546center_optim=0;
547run(fullfile(path_UVMAT,'toolbox_calib','go_calib_optim'));% apply fct 'toolbox_calib/go_calib_optim'
548if exist('Rc_1','var')
549    GeometryCalib.CalibrationType='3D_linear';
550    GeometryCalib.fx_fy=fc';
551    GeometryCalib.Cx_Cy=cc';
552    GeometryCalib.kc=kc(1);
553    GeometryCalib.CoordUnit=[];% default value, to be updated by the calling function
554    GeometryCalib.Tx_Ty_Tz=Tc_1';
555    GeometryCalib.R=Rc_1;
556    GeometryCalib.R(2,1:3)=-GeometryCalib.R(2,1:3);%inversion of the y image coordinate
557    GeometryCalib.Tx_Ty_Tz(2)=-GeometryCalib.Tx_Ty_Tz(2);%inversion of the y image coordinate
558    GeometryCalib.Cx_Cy(2)=ny-GeometryCalib.Cx_Cy(2);%inversion of the y image coordinate
559    GeometryCalib.omc=(180/pi)*omc_1;%angles in degrees
560    GeometryCalib.ErrorRMS=[];
561    GeometryCalib.ErrorMax=[];
562else
563    msgbox_uvmat('ERROR',['calibration function ' fullfile('toolbox_calib','go_calib_optim') ' did not converge: use multiple views or option 3D_extrinsic'])
564    GeometryCalib=[];
565end
566
567%------------------------------------------------------------------------
568function GeometryCalib=calib_3D_quadr(Coord,handles)
569%------------------------------------------------------------------
570
571path_uvmat=which('uvmat');% check the path detected for source file uvmat
572path_UVMAT=fileparts(path_uvmat); %path to UVMAT
573huvmat=findobj(allchild(0),'Tag','uvmat');
574hhuvmat=guidata(huvmat);
575if ~strcmp(get(hhuvmat.Scalar,'Visible'),'on')
576    msgbox_uvmat('ERROR','An image needs to be opened in uvmat for calibration')
577  return
578end
579% check_cond=0;
580coord_files=get(handles.ListCoordFiles,'String');
581if ischar(coord_files)
582    coord_files={coord_files};
583end
584if isempty(coord_files{1}) || isequal(coord_files,{''})
585    coord_files={};
586end
587
588%retrieve the calibration points stored in the files listed in the popup list ListCoordFiles
589x_1=Coord(:,4:5)';%px coordinates of the ref points
590nx=str2num(get(hhuvmat.num_Npx,'String'));
591ny=str2num(get(hhuvmat.num_Npy,'String'));
592x_1(2,:)=ny-x_1(2,:);%reverse the y image coordinates
593X_1=Coord(:,1:3)';%phys coordinates of the ref points
594n_ima=numel(coord_files)+1;
595if ~isempty(coord_files)
596    msgbox_uvmat('CONFIRMATION',['The xy coordinates of the calibration points in ' num2str(n_ima) ' planes will be used'])
597    for ifile=1:numel(coord_files)
598    t=xmltree(coord_files{ifile});
599    s=convert(t);%convert to matlab structure
600        if isfield(s,'GeometryCalib')
601            if isfield(s.GeometryCalib,'SourceCalib')
602                if isfield(s.GeometryCalib.SourceCalib,'PointCoord')
603                PointCoord=s.GeometryCalib.SourceCalib.PointCoord;
604                Coord_file=zeros(length(PointCoord),5);%default
605                for i=1:length(PointCoord)
606                    line=str2num(PointCoord{i});
607                    Coord_file(i,4:5)=line(4:5);%px x
608                    Coord_file(i,1:3)=line(1:3);%phys x
609                end
610                eval(['x_' num2str(ifile+1) '=Coord_file(:,4:5)'';']);
611                eval(['x_' num2str(ifile+1) '(2,:)=ny-x_' num2str(ifile+1) '(2,:);' ]);
612                eval(['X_' num2str(ifile+1) '=Coord_file(:,1:3)'';']);
613                end
614            end
615        end
616    end
617end
618n_ima=numel(coord_files)+1;
619est_dist=[1;0;0;0;0];
620est_aspect_ratio=1;
621center_optim=0;
622run(fullfile(path_UVMAT,'toolbox_calib','go_calib_optim'));% apply fct 'toolbox_calib/go_calib_optim'
623
624if exist('Rc_1','var')
625    GeometryCalib.CalibrationType='3D_quadr';
626    GeometryCalib.fx_fy=fc';
627    GeometryCalib.Cx_Cy=cc';
628    GeometryCalib.kc=kc(1);
629    GeometryCalib.CoordUnit=[];% default value, to be updated by the calling function
630    GeometryCalib.Tx_Ty_Tz=Tc_1';
631    GeometryCalib.R=Rc_1;
632    GeometryCalib.R(2,1:3)=-GeometryCalib.R(2,1:3);%inversion of the y image coordinate
633    GeometryCalib.Tx_Ty_Tz(2)=-GeometryCalib.Tx_Ty_Tz(2);%inversion of the y image coordinate
634    GeometryCalib.Cx_Cy(2)=ny-GeometryCalib.Cx_Cy(2);%inversion of the y image coordinate
635    GeometryCalib.omc=(180/pi)*omc_1;%angles in degrees
636    GeometryCalib.ErrorRMS=[];
637    GeometryCalib.ErrorMax=[];
638else
639    msgbox_uvmat('ERROR',['calibration function ' fullfile('toolbox_calib','go_calib_optim') ' did not converge: use multiple views or option 3D_extrinsic'])
640    GeometryCalib=[];
641end
642
643%------------------------------------------------------------------------
644function GeometryCalib=calib_3D_extrinsic(Coord,handles)
645%------------------------------------------------------------------
646path_uvmat=which('geometry_calib');% check the path detected for source file uvmat
647path_UVMAT=fileparts(path_uvmat); %path to UVMAT
648x_1=double(Coord(:,4:5)');%image coordinates
649X_1=double(Coord(:,1:3)');% phys coordinates
650huvmat=findobj(allchild(0),'Tag','uvmat');
651hhuvmat=guidata(huvmat);
652if ~strcmp(get(hhuvmat.Scalar,'Visible'),'on')
653    msgbox_uvmat('ERROR','An image needs to be opened in uvmat for calibration')
654  return
655end
656ny=str2double(get(hhuvmat.num_Npy,'String'));
657x_1(2,:)=ny-x_1(2,:);%reverse the y image coordinates
658n_ima=1;
659GeometryCalib.CalibrationType='3D_extrinsic';
660fx=str2num(get(handles.fx,'String'));
661fy=str2num(get(handles.fy,'String'));
662Cx=str2num(get(handles.Cx,'String'));
663Cy=str2num(get(handles.Cy,'String'));
664errormsg='';
665if isempty(fx)
666    errormsg='focal length fx needs to be introduced';
667elseif isempty(fy)
668    errormsg='focal length fy needs to be introduced';
669elseif isempty(Cx)
670    errormsg='shift Cx to image centre needs to be introduced';
671elseif isempty(Cy)
672    errormsg='shift Cy to image centre needs to be introduced';
673end
674if ~isempty(errormsg)
675    GeometryCalib=[];
676    msgbox_uvmat('ERROR',errormsg)
677    return
678end
679GeometryCalib.fx_fy(1)=str2num(get(handles.fx,'String'));
680GeometryCalib.fx_fy(2)=str2num(get(handles.fy,'String'));
681GeometryCalib.Cx_Cy(1)=str2num(get(handles.Cx,'String'));
682GeometryCalib.Cx_Cy(2)=str2num(get(handles.Cy,'String'));
683GeometryCalib.kc=str2num(get(handles.kc,'String'));
684fct_path=fullfile(path_UVMAT,'toolbox_calib');
685addpath(fct_path)
686GeometryCalib.Cx_Cy(2)=ny-GeometryCalib.Cx_Cy(2);%reverse Cx_Cy(2) for calibration (inversion of px ordinate)
687[omc,Tc1,Rc1,H,x,ex,JJ] = compute_extrinsic(x_1,X_1,...
688   (GeometryCalib.fx_fy)',GeometryCalib.Cx_Cy',[GeometryCalib.kc 0 0 0 0]);
689rmpath(fct_path);
690GeometryCalib.CoordUnit=[];% default value, to be updated by the calling function
691GeometryCalib.Tx_Ty_Tz=Tc1';
692%inversion of z axis
693GeometryCalib.R=Rc1;
694GeometryCalib.R(2,1:3)=-GeometryCalib.R(2,1:3);%inversion of the y image coordinate
695GeometryCalib.Tx_Ty_Tz(2)=-GeometryCalib.Tx_Ty_Tz(2);%inversion of the y image coordinate
696GeometryCalib.Cx_Cy(2)=ny-GeometryCalib.Cx_Cy(2);%inversion of the y image coordinate
697GeometryCalib.omc=(180/pi)*omc';
698
699%------------------------------------------------------------------------
700%function GeometryCalib=calib_tsai_heikkila(Coord)
701% TEST: NOT IMPLEMENTED
702%------------------------------------------------------------------
703% path_uvmat=which('uvmat');% check the path detected for source file uvmat
704% path_UVMAT=fileparts(path_uvmat); %path to UVMAT
705% path_calib=fullfile(path_UVMAT,'toolbox_calib_heikkila');
706% addpath(path_calib)
707% npoints=size(Coord,1);
708% Coord(:,1:3)=10*Coord(:,1:3);
709% Coord=[Coord zeros(npoints,2) -ones(npoints,1)];
710% [par,pos,iter,res,er,C]=cacal('dalsa',Coord);
711% GeometryCalib.CalibrationType='tsai';
712% GeometryCalib.focal=par(2);
713
714
715%------------------------------------------------------------------------
716% --- determine the rms of calibration error
717function ErrorRms=error_calib(calib_param,Calib,Coord)
718%------------------------------------------------------------------------
719%calib_param: vector of free calibration parameters (to optimise)
720%Calib: structure of the given calibration parameters
721%Coord: list of phys coordinates (columns 1-3, and pixel coordinates (columns 4-5)
722Calib.f=25;
723Calib.dpx=0.012;
724Calib.dpy=0.012;
725Calib.sx=1;
726Calib.Cx=512;
727Calib.Cy=512;
728Calib.kappa1=calib_param(1);
729Calib.Tx=calib_param(2);
730Calib.Ty=calib_param(3);
731Calib.Tz=calib_param(4);
732alpha=calib_param(5);
733Calib.R=[cos(alpha) sin(alpha) 0;-sin(alpha) cos(alpha) 0;0 0 -1];
734
735X=Coord(:,1);
736Y=Coord(:,2);
737Z=Coord(:,3);
738x_ima=Coord(:,4);
739y_ima=Coord(:,5);
740[Xpoints,Ypoints]=px_XYZ(Calib,X,Y,Z);
741ErrorRms(1)=sqrt(mean((Xpoints-x_ima).*(Xpoints-x_ima)));
742ErrorRms(2)=sqrt(mean((Ypoints-y_ima).*(Ypoints-y_ima)));
743ErrorRms=mean(ErrorRms);
744
745
746%------------------------------------------------------------------------
747% --- Executes on button press in STORE.
748function STORE_Callback(hObject, eventdata, handles)
749%------------------------------------------------------------------------
750Coord=get(handles.ListCoord,'Data');
751%Object=read_geometry_calib(Coord_cell);
752unitlist=get(handles.CoordUnit,'String');
753unit=unitlist{get(handles.CoordUnit,'value')};
754GeometryCalib.CoordUnit=unit;
755GeometryCalib.SourceCalib.PointCoord=Coord(:,1:5);
756huvmat=findobj(allchild(0),'Name','uvmat');
757hhuvmat=guidata(huvmat);%handles of elements in the GUI uvmat
758% RootPath='';
759% RootFile='';
760if ~isempty(hhuvmat.RootPath)&& ~isempty(hhuvmat.RootFile)
761%     testhandle=1;
762    RootPath=get(hhuvmat.RootPath,'String');
763    RootFile=get(hhuvmat.RootFile,'String');
764    filebase=[fullfile(RootPath,RootFile) '~'];
765    while exist([filebase '.xml'],'file')
766        filebase=[filebase '~'];
767    end
768    outputfile=[filebase '.xml'];
769    errormsg=update_imadoc(GeometryCalib,outputfile,'GeometryCalib');
770    if ~strcmp(errormsg,'')
771        msgbox_uvmat('ERROR',errormsg);
772    end
773    listfile=get(handles.ListCoordFiles,'string');
774    if isequal(listfile,{''})
775        listfile={outputfile};
776    else
777        listfile=[listfile;{outputfile}];%update the list of coord files
778    end
779    set(handles.ListCoordFiles,'string',listfile);
780end
781CLEAR_PTS_Callback(hObject, eventdata, handles)% clear the current list and point plots
782
783% --------------------------------------------------------------------
784% --- Executes on button press in CLEAR_PTS: clear the list of calibration points
785function CLEAR_PTS_Callback(hObject, eventdata, handles)
786% --------------------------------------------------------------------
787set(handles.ListCoord,'Data',[])
788PLOT_Callback(hObject, eventdata, handles)
789update_calib_marker([]);%remove circle marker
790set(handles.APPLY,'backgroundColor',[1 0 0])% set APPLY button to red color: no calibration wanted without points
791set(handles.CheckEnableMouse,'value',1); %activate mouse to pick new points
792
793%------------------------------------------------------------------------
794% --- Executes on button press in CLEAR LIST
795function CLEAR_Callback(hObject, eventdata, handles)
796%------------------------------------------------------------------------
797set(handles.ListCoordFiles,'Value',1)
798set(handles.ListCoordFiles,'String',{''})
799
800%------------------------------------------------------------------------
801% --- Executes on selection change in CheckEnableMouse.
802function CheckEnableMouse_Callback(hObject, eventdata, handles)
803%------------------------------------------------------------------------
804choice=get(handles.CheckEnableMouse,'Value');
805if choice
806    huvmat=findobj(allchild(0),'tag','uvmat');
807    if ishandle(huvmat)
808        hhuvmat=guidata(huvmat);
809        set(hhuvmat.MenuRuler,'checked','off')%desactivate ruler
810        if get(hhuvmat.CheckEditObject,'Value')
811            set(hhuvmat.CheckEditObject,'Value',0)
812            uvmat('CheckEditObject_Callback',hhuvmat.CheckEditObject,[],hhuvmat)
813        end
814        set(hhuvmat.MenuRuler,'checked','off')%desactivate ruler
815    end
816end
817
818
819% --------------------------------------------------------------------
820function MenuHelp_Callback(hObject, eventdata, handles)
821path_to_uvmat=which('uvmat');% check the path of uvmat
822pathelp=fileparts(path_to_uvmat);
823helpfile=fullfile(pathelp,'uvmat_doc','uvmat_doc.html');
824if isempty(dir(helpfile)), msgbox_uvmat('ERROR','Please put the help file uvmat_doc.html in the sub-directory /uvmat_doc of the UVMAT package')
825else
826   addpath (fullfile(pathelp,'uvmat_doc'))
827   web([helpfile '#geometry_calib'])
828end
829
830% --------------------------------------------------------------------
831function MenuSetScale_Callback(hObject, eventdata, handles)
832
833 answer=msgbox_uvmat('INPUT_TXT','scale pixel/cm?','');
834 %create test points
835 huvmat=findobj(allchild(0),'Name','uvmat');%find the current uvmat interface handle
836UvData=get(huvmat,'UserData');%Data associated to the current uvmat interface
837npy=size(UvData.Field.A,1);
838npx=size(UvData.Field.A,2);
839Xima=[0.25*npx 0.75*npx 0.75*npx 0.25*npx]';
840Yima=[0.25*npy 0.25*npy 0.75*npy 0.75*npy]';
841x=Xima/str2num(answer);
842y=Yima/str2num(answer);
843Coord=[x y zeros(4,1) Xima Yima zeros(4,1)];
844set(handles.ListCoord,'Data',Coord)
845set(handles.APPLY,'BackgroundColor',[1 0 1])
846set(handles.CheckEnableMouse,'value',0); %desactivate mouse to avoid spurious points
847
848%------------------------------------------------------------------------
849function MenuCreateGrid_Callback(hObject, eventdata, handles)
850%------------------------------------------------------------------------
851CalibData=get(handles.geometry_calib,'UserData');
852Tinput=[];%default
853if isfield(CalibData,'grid')
854    Tinput=CalibData.grid;
855end
856[T,CalibData.grid]=create_grid(Tinput);%display the GUI create_grid
857set(handles.geometry_calib,'UserData',CalibData)
858
859%grid in phys space
860Coord=get(handles.ListCoord,'Data');
861Coord(1:size(T,1),1:3)=T;%update the existing list of phys coordinates from the GUI create_grid
862set(handles.ListCoord,'Data',Coord)
863set(handles.APPLY,'BackgroundColor',[1 0 1])
864set(handles.CheckEnableMouse,'value',0); %desactivate mouse to avoid spurious points
865
866% -----------------------------------------------------------------------
867% --- automatic grid dectection from local maxima of the images
868function MenuDetectGrid_Callback(hObject, eventdata, handles)
869%------------------------------------------------------------------------
870%% read the four last point coordinates in pixels
871Coord=get(handles.ListCoord,'Data');%read list of coordinates on geometry_calib
872nbpoints=size(Coord,1); %nbre of calibration points
873if nbpoints~=4
874    msgbox_uvmat('ERROR','four points must have be selected by the mouse to delimitate the phys grid area; the Ox axis will be defined by the two first points')
875    return
876end
877% corners_X=(Coord(end:-1:end-3,4)); %pixel absissa of the four corners
878% corners_Y=(Coord(end:-1:end-3,5));
879corners_X=(Coord(:,4)); %pixel absissa of the four corners
880corners_Y=(Coord(:,5));
881
882%%%%%%
883%   corners_X=1000*[1.5415  1.7557 1.7539 1.5415]';
884%   corners_Y=1000*[1.1515 1.1509 1.3645  1.3639]';
885
886%reorder the last two points (the two first in the list) if needed
887angles=angle((corners_X-corners_X(1))+1i*(corners_Y-corners_Y(1)));
888if abs(angles(4)-angles(2))>abs(angles(3)-angles(2))
889      X_end=corners_X(4);
890      Y_end=corners_Y(4);
891      corners_X(4)=corners_X(3);
892      corners_Y(4)=corners_Y(3);
893      corners_X(3)=X_end;
894      corners_Y(3)=Y_end;
895end
896
897%% initiate the grid in phys coordinates
898CalibData=get(handles.geometry_calib,'UserData');%get information stored on the GUI geometry_calib
899grid_input=[];%default
900if isfield(CalibData,'grid')
901    grid_input=CalibData.grid;%retrieve the previously used grid
902end
903[T,CalibData.grid,CalibData.grid.CheckWhite]=create_grid(grid_input,'detect_grid');%display the GUI create_grid, read the set of phys coordinates T
904set(handles.geometry_calib,'UserData',CalibData)%store the phys grid parameters for later use
905X=[CalibData.grid.x_0 CalibData.grid.x_1 CalibData.grid.x_0 CalibData.grid.x_1]';%corner absissa in the phys coordinates (cm)
906Y=[CalibData.grid.y_0 CalibData.grid.y_0 CalibData.grid.y_1 CalibData.grid.y_1]';%corner ordinates in the phys coordinates (cm)
907
908%% read the current image, displayed in the GUI uvmat
909huvmat=findobj(allchild(0),'Name','uvmat');
910UvData=get(huvmat,'UserData');
911A=UvData.Field.A;%currently displayed image
912npxy=size(A);
913
914%% calculate transform matrices for plane projection: rectangle assumed to be viewed in perspective
915% reference: http://alumni.media.mit.edu/~cwren/interpolator/ by Christopher R. Wren
916B = [ X Y ones(size(X)) zeros(4,3)        -X.*corners_X -Y.*corners_X ...
917      zeros(4,3)        X Y ones(size(X)) -X.*corners_Y -Y.*corners_Y ];
918B = reshape (B', 8 , 8 )';
919D = [ corners_X , corners_Y ];
920D = reshape (D', 8 , 1 );
921l = (B' * B)\B' * D;
922Amat = reshape([l(1:6)' 0 0 1 ],3,3)';
923C = [l(7:8)' 1];
924
925%% transform grid image into 'phys' coordinates
926GeometryCalib.CalibrationType='3D_linear';
927GeometryCalib.fx_fy=[1 1];
928GeometryCalib.Tx_Ty_Tz=[Amat(1,3) Amat(2,3) 1];
929GeometryCalib.R=[Amat(1,1),Amat(1,2),0;Amat(2,1),Amat(2,2),0;C(1),C(2),0];
930GeometryCalib.CoordUnit='cm';
931path_uvmat=which('uvmat');% check the path detected for source file uvmat
932path_UVMAT=fileparts(path_uvmat); %path to UVMAT
933addpath(fullfile(path_UVMAT,'transform_field'))
934Data.ListVarName={'AY','AX','A'};
935Data.VarDimName={'AY','AX',{'AY','AX'}};
936if ndims(A)==3
937    A=mean(A,3);
938end
939Data.A=A-min(min(A));
940Data.AY=[npxy(1)-0.5 0.5];
941Data.AX=[0.5 npxy(2)];
942Data.CoordUnit='pixel';
943Calib.GeometryCalib=GeometryCalib;
944DataOut=phys(Data,Calib);
945rmpath(fullfile(path_UVMAT,'transform_field'))
946Amod=DataOut.A;% current image expressed in 'phys' coord
947Rangx=DataOut.AX;% x coordinates of first and last pixel centres in phys
948Rangy=DataOut.AY;% y coordinates of first and last pixel centres in phys
949if CalibData.grid.CheckWhite
950    Amod=double(Amod);%case of white grid markers: will look for image maxima
951else
952    Amod=-double(Amod);%case of black grid markers: will look for image minima
953end
954
955%% detection of local image extrema in each direction
956Dx=(Rangx(2)-Rangx(1))/(npxy(2)-1); %x mesh in real space
957Dy=(Rangy(2)-Rangy(1))/(npxy(1)-1); %y mesh in real space
958ind_range_x=ceil(abs(GeometryCalib.R(1,1)*CalibData.grid.Dx/3));% range of search of image ma around each point obtained by linear interpolation from the marked points
959ind_range_y=ceil(abs(GeometryCalib.R(2,2)*CalibData.grid.Dy/3));% range of search of image ma around each point obtained by linear interpolation from the marked points
960nbpoints=size(T,1);
961TIndex=ones(size(T));% image indices corresponding to point coordinates
962%look for image maxima around each expected grid point
963for ipoint=1:nbpoints
964    i0=1+round((T(ipoint,1)-Rangx(1))/Dx);% x index of the expected point in the phys image Amod
965    j0=1+round((T(ipoint,2)-Rangy(1))/Dy);% y index of the expected point in the phys image Amod
966    j0min=max(j0-ind_range_y,1);% min y index selected for the subimage (cut at the edge to avoid index <1)
967    j0max=min(j0+ind_range_y,size(Amod,1));% max y index selected for the subimage (cut at the edge to avoid index > size)
968    i0min=max(i0-ind_range_x,1);% min x index selected for the subimage (cut at the edge to avoid index <1)
969    i0max=min(i0+ind_range_x,size(Amod,2));% max x index selected for the subimage (cut at the edge to avoid index > size)
970    Asub=Amod(j0min:j0max,i0min:i0max); %subimage used to find brigthness extremum
971    x_profile=sum(Asub,1);%profile of subimage summed over y
972    y_profile=sum(Asub,2);%profile of subimage summed over x
973
974    [tild,ind_x_max]=max(x_profile);% index of max for the x profile
975    [tild,ind_y_max]=max(y_profile);% index of max for the y profile
976    %sub-pixel improvement using moments
977    x_shift=0;
978    y_shift=0;
979    if ind_x_max+2<=numel(x_profile) && ind_x_max-2>=1
980        Atop=x_profile(ind_x_max-2:ind_x_max+2);% extract x profile around the max
981        x_shift=sum(Atop.*[-2 -1 0 1 2])/sum(Atop);
982    end
983    if ind_y_max+2<=numel(y_profile) && ind_y_max-2>=1
984        Atop=y_profile(ind_y_max-2:ind_y_max+2);% extract y profile around the max
985        y_shift=sum(Atop.*[-2 -1 0 1 2]')/sum(Atop);
986    end
987        %%%%
988%     if ipoint==9
989%                 figure(11)
990%   imagesc(Asub)
991%     figure(12)
992%     plot(x_profile,'r')
993%     hold on
994%     plot(y_profile,'b')
995%     grid on
996%     end
997    %%%%
998    TIndex(ipoint,1)=(i0min+ind_x_max-1+x_shift);% x position of the maximum (in index of Amod)
999    TIndex(ipoint,2)=(j0min+ind_y_max-1+y_shift);% y position of the maximum (in index of Amod)
1000end
1001Tmod(:,1)=(TIndex(:,1)-1)*Dx+Rangx(1);
1002Tmod(:,2)=(TIndex(:,2)-1)*Dy+Rangy(1);
1003%Tmod=T(:,(1:2))+Delta;% 'phys' coordinates of the detected points
1004[Xpx,Ypx]=px_XYZ(GeometryCalib,Tmod(:,1),Tmod(:,2));% image coordinates of the detected points
1005Coord=[T Xpx Ypx zeros(size(T,1),1)];
1006set(handles.ListCoord,'Data',Coord)
1007PLOT_Callback(hObject, eventdata, handles)
1008set(handles.APPLY,'BackgroundColor',[1 0 1])
1009set(handles.CheckEnableMouse,'value',0); %desactivate mouse to avoid spurious points
1010
1011
1012%-----------------------------------------------------------------------
1013function MenuTranslatePoints_Callback(hObject, eventdata, handles)
1014%-----------------------------------------------------------------------
1015%hcalib=get(handles.calib_type,'parent');%handles of the GUI geometry_calib
1016CalibData=get(handles.geometry_calib,'UserData');
1017Tinput=[];%default
1018if isfield(CalibData,'translate')
1019    Tinput=CalibData.translate;
1020end
1021T=translate_points(Tinput);%display translate_points GUI and get shift parameters
1022CalibData.translate=T;
1023set(handles.geometry_calib,'UserData',CalibData)
1024%translation
1025Coord=get(handles.ListCoord,'Data');
1026Coord(:,1)=T(1)+Coord(:,1);
1027Coord(:,2)=T(2)+Coord(:,2);
1028Coord(:,3)=T(3)+Coord(:,3);
1029set(handles.ListCoord,'Data',Coord);
1030set(handles.APPLY,'BackgroundColor',[1 0 1])
1031
1032% --------------------------------------------------------------------
1033function MenuRotatePoints_Callback(hObject, eventdata, handles)
1034%hcalib=get(handles.calib_type,'parent');%handles of the GUI geometry_calib
1035CalibData=get(handles.geometry_calib,'UserData');
1036Tinput=[];%default
1037if isfield(CalibData,'rotate')
1038    Tinput=CalibData.rotate;
1039end
1040T=rotate_points(Tinput);%display rotate_points GUI to introduce rotation parameters
1041CalibData.rotate=T;
1042set(handles.geometry_calib,'UserData',CalibData)
1043%-----------------------------------------------------
1044%rotation
1045Phi=T(1);
1046O_x=0;%default
1047O_y=0;%default
1048if numel(T)>=2
1049    O_x=T(2);%default
1050end
1051if numel(T)>=3
1052    O_y=T(3);%default
1053end
1054Coord=get(handles.ListCoord,'Data');
1055r1=cos(pi*Phi/180);
1056r2=-sin(pi*Phi/180);
1057r3=sin(pi*Phi/180);
1058r4=cos(pi*Phi/180);
1059x=Coord(:,1)-O_x;
1060y=Coord(:,2)-O_y;
1061Coord(:,1)=r1*x+r2*y;
1062Coord(:,2)=r3*x+r4*y;
1063set(handles.ListCoord,'Data',Coord)
1064set(handles.APPLY,'BackgroundColor',[1 0 1])
1065
1066% --------------------------------------------------------------------
1067function MenuImportPoints_Callback(hObject, eventdata, handles)
1068fileinput=browse_xml(hObject, eventdata, handles);
1069if isempty(fileinput)
1070    return
1071end
1072[s,errormsg]=imadoc2struct(fileinput,'GeometryCalib');
1073if ~isfield(s,'GeometryCalib')
1074    msgbox_uvmat('ERROR','invalid input file: no geometry_calib data')
1075    return
1076end
1077GeometryCalib=s.GeometryCalib;
1078if ~(isfield(GeometryCalib,'SourceCalib')&&isfield(GeometryCalib.SourceCalib,'PointCoord'))
1079        msgbox_uvmat('ERROR','invalid input file: no calibration points')
1080    return
1081end
1082Coord=GeometryCalib.SourceCalib.PointCoord;
1083Coord=[Coord zeros(size(Coord,1),1)];
1084set(handles.ListCoord,'Data',Coord)
1085PLOT_Callback(handles.geometry_calib, [], handles)
1086set(handles.APPLY,'BackgroundColor',[1 0 1])
1087set(handles.CheckEnableMouse,'value',0); %desactivate mouse to avoid modifications by default
1088
1089% -----------------------------------------------------------------------
1090function MenuImportIntrinsic_Callback(hObject, eventdata, handles)
1091%------------------------------------------------------------------------
1092fileinput=browse_xml(hObject, eventdata, handles);
1093if isempty(fileinput)
1094    return
1095end
1096[s,errormsg]=imadoc2struct(fileinput,'GeometryCalib');
1097GeometryCalib=s.GeometryCalib;
1098display_intrinsic(GeometryCalib,handles)
1099
1100% -----------------------------------------------------------------------
1101function MenuImportAll_Callback(hObject, eventdata, handles)
1102%------------------------------------------------------------------------
1103fileinput=browse_xml(hObject, eventdata, handles);
1104if ~isempty(fileinput)
1105    loadfile(handles,fileinput)
1106end
1107set(handles.CheckEnableMouse,'value',0); %desactivate mouse to avoid modifications by default
1108
1109% -----------------------------------------------------------------------
1110% --- Executes on menubar option Import/Grid file: introduce previous grid files
1111function MenuGridFile_Callback(hObject, eventdata, handles)
1112% -----------------------------------------------------------------------
1113inputfile=browse_xml(hObject, eventdata, handles);
1114listfile=get(handles.ListCoordFiles,'String');
1115if isequal(listfile,{''})
1116    listfile={inputfile};
1117else
1118    listfile=[listfile;{inputfile}];%update the list of coord files
1119end
1120set(handles.ListCoordFiles,'String',listfile);
1121
1122
1123%------------------------------------------------------------------------
1124function fileinput=browse_xml(hObject, eventdata, handles)
1125%------------------------------------------------------------------------
1126fileinput=[];%default
1127oldfile=''; %default
1128UserData=get(handles.geometry_calib,'UserData');
1129if isfield(UserData,'XmlInputFile')
1130    oldfile=UserData.XmlInputFile;
1131end
1132[FileName, PathName, filterindex] = uigetfile( ...
1133       {'*.xml;*.mat', ' (*.xml,*.mat)';
1134       '*.xml',  '.xml files '; ...
1135        '*.mat',  '.mat matlab files '}, ...
1136        'Pick a file',oldfile);
1137fileinput=[PathName FileName];%complete file name
1138testblank=findstr(fileinput,' ');%look for blanks
1139if ~isempty(testblank)
1140    msgbox_uvmat('ERROR','forbidden input file name or path: no blank character allowed')
1141    return
1142end
1143sizf=size(fileinput);
1144if (~ischar(fileinput)||~isequal(sizf(1),1)),return;end
1145UserData.XmlInputFile=fileinput;
1146set(handles.geometry_calib,'UserData',UserData)%record current file foer further use of browser
1147
1148% -----------------------------------------------------------------------
1149function Heading=loadfile(handles,fileinput)
1150%------------------------------------------------------------------------
1151Heading=[];%default
1152[s,errormsg]=imadoc2struct(fileinput,'Heading','GeometryCalib');
1153if ~isempty(errormsg)
1154    msgbox_uvmat('ERROR',errormsg)
1155    return
1156end
1157if ~isempty(s.Heading)
1158    Heading=s.Heading;
1159end
1160
1161GeometryCalib=s.GeometryCalib;
1162fx=1;fy=1;Cx=0;Cy=0;kc=0; %default
1163CoordCell={};
1164Tabchar={};%default
1165val_cal=1;%default
1166if ~isempty(GeometryCalib)
1167    % choose the calibration option
1168    if isfield(GeometryCalib,'CalibrationType')
1169        calib_list=get(handles.calib_type,'String');
1170        for ilist=1:numel(calib_list)
1171            if strcmp(calib_list{ilist},GeometryCalib.CalibrationType)
1172                val_cal=ilist;
1173                break
1174            end
1175        end
1176    end
1177    display_intrinsic(GeometryCalib,handles)%intrinsic param
1178    %extrinsic param
1179    if isfield(GeometryCalib,'Tx_Ty_Tz')
1180        Tx_Ty_Tz=GeometryCalib.Tx_Ty_Tz;
1181        set(handles.Tx,'String',num2str(GeometryCalib.Tx_Ty_Tz(1),4))
1182        set(handles.Ty,'String',num2str(GeometryCalib.Tx_Ty_Tz(2),4))
1183        set(handles.Tz,'String',num2str(GeometryCalib.Tx_Ty_Tz(3),4))
1184    end
1185    if isfield(GeometryCalib,'omc')
1186        set(handles.Phi,'String',num2str(GeometryCalib.omc(1),4))
1187        set(handles.Theta,'String',num2str(GeometryCalib.omc(2),4))
1188        set(handles.Psi,'String',num2str(GeometryCalib.omc(3),4))
1189    end
1190    if isfield(GeometryCalib,'SourceCalib')&& isfield(GeometryCalib.SourceCalib,'PointCoord')
1191        calib=GeometryCalib.SourceCalib.PointCoord;
1192        Coord=[calib zeros(size(calib,1),1)];
1193        set(handles.ListCoord,'Data',Coord)
1194    end
1195    PLOT_Callback(handles.geometry_calib, [], handles)
1196    set(handles.APPLY,'BackgroundColor',[1 0 1])
1197end
1198set(handles.calib_type,'Value',val_cal)
1199
1200if isempty(CoordCell)% allow mouse action by default in the absence of input points
1201    set(handles.CheckEnableMouse,'Value',1)
1202    set(handles.CheckEnableMouse,'BackgroundColor',[1 1 0])
1203else % does not allow mouse action by default in the presence of input points
1204    set(handles.CheckEnableMouse,'Value',0)
1205    set(handles.CheckEnableMouse,'BackgroundColor',[0.7 0.7 0.7])
1206end
1207
1208%------------------------------------------------------------------------
1209%---display calibration intrinsic parameters
1210function display_intrinsic(GeometryCalib,handles)
1211%------------------------------------------------------------------------
1212fx=[];
1213fy=[];
1214if isfield(GeometryCalib,'fx_fy')
1215    fx=GeometryCalib.fx_fy(1);
1216    fy=GeometryCalib.fx_fy(2);
1217end
1218Cx_Cy=[0 0];%default
1219if isfield(GeometryCalib,'Cx_Cy')
1220    Cx_Cy=GeometryCalib.Cx_Cy;
1221end
1222kc=0;
1223if isfield(GeometryCalib,'kc')
1224    kc=GeometryCalib.kc; %* GeometryCalib.focal*GeometryCalib.focal;
1225end
1226set(handles.fx,'String',num2str(fx,5))
1227set(handles.fy,'String',num2str(fy,5))
1228set(handles.Cx,'String',num2str(Cx_Cy(1),'%1.1f'))
1229set(handles.Cy,'String',num2str(Cx_Cy(2),'%1.1f'))
1230set(handles.kc,'String',num2str(kc,'%1.4f'))
1231
1232
1233% --- Executes when user attempts to close geometry_calib.
1234function geometry_calib_CloseRequestFcn(hObject, eventdata, handles)
1235
1236delete(hObject); % closes the figure
1237
1238%------------------------------------------------------------------------
1239% --- Executes on button press in PLOT.
1240%------------------------------------------------------------------------
1241function PLOT_Callback(hObject, eventdata, handles)
1242huvmat=findobj(allchild(0),'Name','uvmat');%find the current uvmat interface handle
1243hhuvmat=guidata(huvmat); %handles of GUI elements in uvmat
1244h_menu_coord=findobj(huvmat,'Tag','TransformName');
1245menu=get(h_menu_coord,'String');
1246choice=get(h_menu_coord,'Value');
1247option='';
1248if iscell(menu)
1249    option=menu{choice};
1250end
1251Coord=get(handles.ListCoord,'Data');
1252if ~isempty(Coord)
1253    if isequal(option,'phys')
1254        Coord_plot=Coord(:,1:3);
1255    elseif isempty(option);%optionoption,'px')||isequal(option,'')
1256        Coord_plot=Coord(:,4:5);
1257    else
1258        msgbox_uvmat('ERROR','the choice in menu_coord of uvmat must be blank or phys ')
1259    end
1260end
1261
1262set(0,'CurrentFigure',huvmat)
1263set(huvmat,'CurrentAxes',hhuvmat.PlotAxes)
1264hh=findobj('Tag','calib_points');
1265if  ~isempty(Coord) && isempty(hh)
1266    hh=line(Coord_plot(:,1),Coord_plot(:,2),'Color','m','Tag','calib_points','LineStyle','.','Marker','+','MarkerSize',10);
1267elseif isempty(Coord)%empty list of points, suppress the plot
1268    delete(hh)
1269else
1270    set(hh,'XData',Coord_plot(:,1))
1271    set(hh,'YData',Coord_plot(:,2))
1272end
1273pause(.1)
1274figure(handles.geometry_calib)
1275
1276%------------------------------------------------------------------------
1277% --- Executes on button press in Copy: display Coord on the Matlab work space
1278%------------------------------------------------------------------------
1279function Copy_Callback(hObject, eventdata, handles)
1280global Coord
1281evalin('base','global Coord')%make CurData global in the workspace
1282Coord=get(handles.ListCoord,'Data');
1283display('coordinates of calibration points (phys,px,marker) :')
1284evalin('base','Coord') %display CurData in the workspace
1285commandwindow; %brings the Matlab command window to the front
1286
1287%------------------------------------------------------------------------
1288% --- Executes when selected cell(s) is changed in ListCoord.
1289%------------------------------------------------------------------------
1290function ListCoord_CellSelectionCallback(hObject, eventdata, handles)
1291if ~isempty(eventdata.Indices)
1292    iline=eventdata.Indices(1);% selected line number
1293    set(handles.CoordLine,'String',num2str(iline))
1294     Data=get(handles.ListCoord,'Data');
1295     update_calib_marker(Data(iline,:))
1296end
1297
1298%------------------------------------------------------------------------
1299% --- Executes when entered data in editable cell(s) in ListCoord.
1300%------------------------------------------------------------------------
1301function ListCoord_CellEditCallback(hObject, eventdata, handles)
1302
1303Input=str2num(eventdata.EditData);%pasted input
1304Coord=get(handles.ListCoord,'Data');
1305iline=eventdata.Indices(1);% selected line number
1306if size(Coord,1)<iline+numel(Input)
1307    Coord=[Coord ; zeros(iline+numel(Input)-size(Coord,1),6)];% append zeros to fit the new column
1308end
1309Coord(iline:iline+numel(Input)-1,eventdata.Indices(2))=Input';
1310set(handles.ListCoord,'Data',Coord)
1311PLOT_Callback(hObject, eventdata, handles)
1312
1313%------------------------------------------------------------------------
1314% --- 'key_press_fcn:' function activated when a key is pressed on the keyboard
1315%------------------------------------------------------------------------
1316function ListCoord_KeyPressFcn(hObject, eventdata, handles)
1317iline=str2num(get(handles.CoordLine,'String'));
1318xx=double(get(handles.geometry_calib,'CurrentCharacter'));%get the keyboard character
1319if ismember(xx,[28 29 30 31])% directional arrow
1320    Coord=get(handles.ListCoord,'Data');
1321    switch xx
1322        case 30 % arrow upward
1323            iline=iline-1;
1324        case 31% arrow downward
1325            iline=iline+1;
1326    end
1327    if iline>=1 && iline<=size(Coord,1)
1328        set(handles.CoordLine,'String',num2str(iline))
1329        update_calib_marker(Coord(iline,1:5))% show the point corresponding to the selected line
1330    end
1331else
1332    set(handles.APPLY,'BackgroundColor',[1 0 1])% paint APPLY in magenta to indicate that the table content has be modified
1333end
1334
1335
1336%------------------------------------------------------------------------
1337% --- update the plot of calibration points
1338%------------------------------------------------------------------------
1339% draw a circle around the point defined by the input coordinates Coord as given by line in the table Listcoord
1340function update_calib_marker(Coord)
1341
1342%% read config on uvmat
1343huvmat=findobj(allchild(0),'Name','uvmat');%find the current uvmat interface handle
1344hhuvmat=guidata(huvmat);
1345hhh=findobj(hhuvmat.PlotAxes,'Tag','calib_marker');
1346if numel(Coord)<5
1347    if ~isempty(hhh)
1348        delete(hhh)%delete the circle marker in case of no valid input
1349    end
1350    return
1351end
1352menu=get(hhuvmat.TransformName,'String');
1353choice=get(hhuvmat.TransformName,'Value');
1354option='';
1355if iscell(menu)
1356    option=menu{choice};
1357end
1358
1359%% read appropriate coordinates (px or phys) in the table ListCoord
1360if isequal(option,'phys') % use phys coord
1361    XCoord=Coord(1);
1362    YCoord=Coord(2);
1363elseif isempty(option)% use coord in pixels
1364    XCoord=Coord(4);
1365    YCoord=Coord(5);
1366else
1367    msgbox_uvmat('ERROR','the choice in menu_coord of uvmat must be blank or phys ')
1368    return
1369end
1370
1371%% adjust the plot limits if needed
1372xlim=get(hhuvmat.PlotAxes,'XLim');
1373ylim=get(hhuvmat.PlotAxes,'YLim');
1374ind_range=max(abs(xlim(2)-xlim(1)),abs(ylim(end)-ylim(1)))/25;%defines the size of the circle marker
1375check_xlim=0;
1376if XCoord>xlim(2)
1377    xlim=xlim+XCoord-xlim(2)+ind_range;% translate plot limit
1378    check_xlim=1;
1379elseif XCoord<xlim(1)
1380    xlim=xlim-XCoord+xlim(1)-ind_range;% translate plot limit
1381    check_xlim=1;
1382end
1383if check_xlim
1384    set(hhuvmat.PlotAxes,'XLim',xlim);
1385    set(hhuvmat.num_MaxX,'String',num2str(xlim(2)));
1386    set(hhuvmat.num_MinX,'String',num2str(xlim(1)));
1387end
1388check_ylim=0;
1389if YCoord>ylim(2)
1390    ylim=ylim+YCoord-ylim(2)+ind_range;% translate plot limit
1391    check_ylim=1;
1392elseif YCoord<ylim(1)
1393    ylim=ylim-YCoord+ylim(1)-ind_range;% translate plot limit
1394    check_ylim=1;
1395end
1396if check_ylim
1397    set(hhuvmat.PlotAxes,'YLim',ylim);
1398    set(hhuvmat.num_MaxY,'String',num2str(ylim(2)));
1399    set(hhuvmat.num_MinY,'String',num2str(ylim(1)));
1400end
1401
1402%% plot a circle around the selected point
1403if isempty(hhh)
1404    set(0,'CurrentFig',huvmat)
1405    set(huvmat,'CurrentAxes',hhuvmat.PlotAxes)
1406    rectangle('Curvature',[1 1],...
1407        'Position',[XCoord-ind_range/2 YCoord-ind_range/2 ind_range ind_range],'EdgeColor','m',...
1408        'LineStyle','-','Tag','calib_marker');
1409else
1410    set(hhh,'Position',[XCoord-ind_range/2 YCoord-ind_range/2 ind_range ind_range])
1411end
1412
1413%------------------------------------------------------------------------
1414% --- Executes on button press in ClearLine: remove the selected line in the table Coord
1415%------------------------------------------------------------------------
1416function ClearLine_Callback(hObject, eventdata, handles)
1417
1418Coord=get(handles.ListCoord,'Data');
1419iline=str2num(get(handles.CoordLine,'String'));
1420if isempty(iline)
1421    msgbox_uvmat('WARNING','no line suppressed, select a line in the table')
1422else
1423    answer=msgbox_uvmat('INPUT_Y-N',['suppress line ' num2str(iline) '?']);
1424    if isequal(answer,'Yes')
1425        Coord(iline,:)=[];
1426        set(handles.APPLY,'BackgroundColor',[1 0 1])
1427        set(handles.ListCoord,'Data',Coord);
1428        set(handles.CoordLine,'String','')
1429        PLOT_Callback(hObject,eventdata,handles)
1430        update_calib_marker([]);%remove circle marker
1431    end
1432end
1433
Note: See TracBrowser for help on using the repository browser.