Difference between revisions of "Support:Bugs and solutions"
Line 1: | Line 1: | ||
− | + | == How this system works == | |
+ | #If a user encounters an error, he may read the 'Known bugs and solutions' section below to find if this error has been reported and solved. If not, the users report this bug in the 'Report new bugs' section. | ||
+ | #As this page is being 'watched' by COMKAT developers, any changes to this page will trigger the wiki to send us an e-mail notifying us of the new bug report. | ||
+ | #Then we will look at the bug report, provide an answer and solution and reply to the user who reported it via e-mail. | ||
+ | #Once this bug is resolved, we will move the report from the 'Report new bugs' section to the 'Previous bugs and solutions' section. | ||
+ | '''NOTE:''' This page will not contain the bug reports for the previous releases of COMKAT if this bug has been resolved in the new version. | ||
− | == | + | == How to submit a bug report == |
− | [ | + | #Get the following information of your system: |
+ | ##Operating system | ||
+ | ##Matlab version (use command 'ver' in Matlab to obtain it) | ||
+ | ##COMKAT version | ||
+ | #Copy the following text. | ||
+ | <pre> | ||
+ | Bug reported by [Your name]. <nowiki>[mailto:Your e-mail]</nowiki> | ||
− | + | OS: [Your OS] | |
+ | Matlab: [Your matlab version] | ||
+ | |||
+ | COMKAT: [Your COMKAT version] | ||
+ | |||
+ | Bug description: [Describe your bug] | ||
+ | |||
+ | Attachment(optional): | ||
+ | |||
+ | Additional contact information (optional): | ||
+ | </pre> | ||
+ | |||
+ | Then click 'Edit' near the bottom of this page. Paste the text into the edit box under '== Report new bugs =='. Edit the pasted text according to the bug you found. When finished click 'Save page'. You may also include attachments such as .mat or .m files. | ||
+ | |||
+ | Go to [[Support:Detailed tutorial on bug report]] for a more detailed step-by-step instruction with pictures. | ||
+ | |||
+ | == New bugs waiting for response == | ||
+ | <br> | ||
Bug reported by Freddie. mailto: freddie.781@gmail.com | Bug reported by Freddie. mailto: freddie.781@gmail.com | ||
− | |||
OS: Microsoft Windows XP Version 5.1 (Build 2600: Service Pack 2) | OS: Microsoft Windows XP Version 5.1 (Build 2600: Service Pack 2) | ||
Line 17: | Line 44: | ||
Bug description: I just downloaded and attempted to install the latest version of COMKAT. When attempting to validate the first calculation, I get the following error message: | Bug description: I just downloaded and attempted to install the latest version of COMKAT. When attempting to validate the first calculation, I get the following error message: | ||
− | ??? Undefined command/function 'pxEval'. | + | <pre>??? Undefined command/function 'pxEval'. |
Error in ==> compartmentModel.solve at 37 | Error in ==> compartmentModel.solve at 37 | ||
− | + | ||
+ | nsens = nsens + length(pxEval(cm,sensitivityName{i})); | ||
Error in ==> validateFlow at 31 | Error in ==> validateFlow at 31 | ||
− | + | ||
+ | [PET, PETIndex, Out, OutIndex] = solve(cmFlow); | ||
??? Error while evaluating uicontrol Callback. | ??? Error while evaluating uicontrol Callback. | ||
− | + | </pre> | |
Attempts to validate the other calculations result in the same error message. At first, I thought that I set up the path incorrectly. I later removed the COMKAT root directory, and its subdirectories, from the MATLAB path, and then included it again using the SetComkatPath.m script (which ran without reporting any errors). However, the attempts to validate after that provided the same error messages. Please investigate, and inform me of mistakes or solutions. | Attempts to validate the other calculations result in the same error message. At first, I thought that I set up the path incorrectly. I later removed the COMKAT root directory, and its subdirectories, from the MATLAB path, and then included it again using the SetComkatPath.m script (which ran without reporting any errors). However, the attempts to validate after that provided the same error messages. Please investigate, and inform me of mistakes or solutions. | ||
Attachment(optional): | Attachment(optional): | ||
− | Additional contact information (optional): | + | Additional contact information (optional): |
+ | |||
+ | == Known bugs and solutions == | ||
+ | ==== Download and installation ==== | ||
+ | #When I clicked the link to COMKAT download, the download did not start and I got a 'HTTP 403 Forbidden' error message. <br>'''Solution:'''The COMKAT server requires you to register and log in before you download the COMKAT files. | ||
+ | #The fitting function in the example fdgcmd.m returns this error <pre>fdgcmd('INVERSE') plotOption = 1 ??? Input argument "cm" is undefined. Error in ==> fitfunc at 54 parmToChange = get(cm, 'SensitivityName'); Error in ==> optim\private\snls at 423 [newfvec,newA] = feval(funfcn{3},xargin{:},varargin{:}); Error in ==> optim\private\lsqncommon at 220 [x,FVAL,LAMBDA,JACOB,EXITFLAG,OUTPUT,msg]=... Error in ==> lsqcurvefit at 174 [x,Resnorm,FVAL,EXITFLAG,OUTPUT,LAMBDA,JACOB] = ... Error in ==> compartmentModel.fit at 145 [newParmVal,resnorm,residual,exitFlag,output,lambda,jacobian] = lsqcurvefit('fitfunc', initParmVal, [], data, lb, ub, ... Error in ==> fdgcmd at 208 pfit = fit(cm, pinit, lb, ub);</pre><br>'''Solution:'''This error arises because the newer Matlab function "lsqcurvefit" has a different argument passing. In Matlab version earlier than R2006, the lsqcommon passes an extra argument which is empty. That is why there is an "unused" argement in the fitfunc.m. However, this is fixed in R2006a and later so now the cm is passed as "unused". If you are using Matlab 2006a or later, to solve this problem as a workaround, edit the "fitfunc.m" and insert the following lines in line 38: if nargin<3 cm=unused; end | ||
+ | #I use two computers, one xp sp1 with matlab v7 sp1, the other is sp2. The estimated value from both computers are different. I have checked many times that I use the same data. Would it be possible to happen?<br>'''Solution:'''The default optimizer of COMKAT is lsqcurvefit. As it is a function of the Matlab optimization toolbox, in different versions of Matlab the fitting results may differ. So the fitted values could be slightly different under different service packs. However, the optimizer "LMWLS" is a function of COMKAT so it will not change in different Matlab versions. So if you use this optimizer you will get the identical parameter estimates regardless the Matlab version. | ||
+ | |||
+ | ==== COMKAT command line functions ==== | ||
+ | #When I tried to set a certain property of COMKAT compartment model, why wasn't the property changed?<br>'''Solution:'''A common mistake is that you used a command without assigning the correct output like: <pre>set(cm,'ParameterName',pnames);</pre> But the correct usage is: <pre>cm=set(cm,'ParameterName',pnames);</pre> | ||
+ | |||
+ | ==== COMKAT GUI ==== | ||
+ | #Main_GUI -> Model drawer -> I cannot find the "Return to GUI" button when using the Model drawer.<br>'''Solution:'''You have to implement every step including "check model compatibility" and "Return to GUI" will be enabled. | ||
+ | ==== COMKAT Image Tool ==== | ||
− | == | + | ==== Misc ==== |
Revision as of 22:45, 18 February 2008
How this system works
- If a user encounters an error, he may read the 'Known bugs and solutions' section below to find if this error has been reported and solved. If not, the users report this bug in the 'Report new bugs' section.
- As this page is being 'watched' by COMKAT developers, any changes to this page will trigger the wiki to send us an e-mail notifying us of the new bug report.
- Then we will look at the bug report, provide an answer and solution and reply to the user who reported it via e-mail.
- Once this bug is resolved, we will move the report from the 'Report new bugs' section to the 'Previous bugs and solutions' section.
NOTE: This page will not contain the bug reports for the previous releases of COMKAT if this bug has been resolved in the new version.
How to submit a bug report
- Get the following information of your system:
- Operating system
- Matlab version (use command 'ver' in Matlab to obtain it)
- COMKAT version
- Copy the following text.
Bug reported by [Your name]. [mailto:Your e-mail] OS: [Your OS] Matlab: [Your matlab version] COMKAT: [Your COMKAT version] Bug description: [Describe your bug] Attachment(optional): Additional contact information (optional):
Then click 'Edit' near the bottom of this page. Paste the text into the edit box under '== Report new bugs =='. Edit the pasted text according to the bug you found. When finished click 'Save page'. You may also include attachments such as .mat or .m files.
Go to Support:Detailed tutorial on bug report for a more detailed step-by-step instruction with pictures.
New bugs waiting for response
Bug reported by Freddie. mailto: freddie.781@gmail.com
OS: Microsoft Windows XP Version 5.1 (Build 2600: Service Pack 2)
Matlab: MATLAB Version 7.0.4.365 (R14) Service Pack 2
COMKAT: COMKAT Release 3 (R3)
Bug description: I just downloaded and attempted to install the latest version of COMKAT. When attempting to validate the first calculation, I get the following error message:
??? Undefined command/function 'pxEval'. Error in ==> compartmentModel.solve at 37 nsens = nsens + length(pxEval(cm,sensitivityName{i})); Error in ==> validateFlow at 31 [PET, PETIndex, Out, OutIndex] = solve(cmFlow); ??? Error while evaluating uicontrol Callback.
Attempts to validate the other calculations result in the same error message. At first, I thought that I set up the path incorrectly. I later removed the COMKAT root directory, and its subdirectories, from the MATLAB path, and then included it again using the SetComkatPath.m script (which ran without reporting any errors). However, the attempts to validate after that provided the same error messages. Please investigate, and inform me of mistakes or solutions.
Attachment(optional):
Additional contact information (optional):
Known bugs and solutions
Download and installation
- When I clicked the link to COMKAT download, the download did not start and I got a 'HTTP 403 Forbidden' error message.
Solution:The COMKAT server requires you to register and log in before you download the COMKAT files. - The fitting function in the example fdgcmd.m returns this error
fdgcmd('INVERSE') plotOption = 1 ??? Input argument "cm" is undefined. Error in ==> fitfunc at 54 parmToChange = get(cm, 'SensitivityName'); Error in ==> optim\private\snls at 423 [newfvec,newA] = feval(funfcn{3},xargin{:},varargin{:}); Error in ==> optim\private\lsqncommon at 220 [x,FVAL,LAMBDA,JACOB,EXITFLAG,OUTPUT,msg]=... Error in ==> lsqcurvefit at 174 [x,Resnorm,FVAL,EXITFLAG,OUTPUT,LAMBDA,JACOB] = ... Error in ==> compartmentModel.fit at 145 [newParmVal,resnorm,residual,exitFlag,output,lambda,jacobian] = lsqcurvefit('fitfunc', initParmVal, [], data, lb, ub, ... Error in ==> fdgcmd at 208 pfit = fit(cm, pinit, lb, ub);
Solution:This error arises because the newer Matlab function "lsqcurvefit" has a different argument passing. In Matlab version earlier than R2006, the lsqcommon passes an extra argument which is empty. That is why there is an "unused" argement in the fitfunc.m. However, this is fixed in R2006a and later so now the cm is passed as "unused". If you are using Matlab 2006a or later, to solve this problem as a workaround, edit the "fitfunc.m" and insert the following lines in line 38: if nargin<3 cm=unused; end - I use two computers, one xp sp1 with matlab v7 sp1, the other is sp2. The estimated value from both computers are different. I have checked many times that I use the same data. Would it be possible to happen?
Solution:The default optimizer of COMKAT is lsqcurvefit. As it is a function of the Matlab optimization toolbox, in different versions of Matlab the fitting results may differ. So the fitted values could be slightly different under different service packs. However, the optimizer "LMWLS" is a function of COMKAT so it will not change in different Matlab versions. So if you use this optimizer you will get the identical parameter estimates regardless the Matlab version.
COMKAT command line functions
- When I tried to set a certain property of COMKAT compartment model, why wasn't the property changed?
Solution:A common mistake is that you used a command without assigning the correct output like:set(cm,'ParameterName',pnames);
But the correct usage is:cm=set(cm,'ParameterName',pnames);
COMKAT GUI
- Main_GUI -> Model drawer -> I cannot find the "Return to GUI" button when using the Model drawer.
Solution:You have to implement every step including "check model compatibility" and "Return to GUI" will be enabled.