Support:Bugs and solutions

How this system works

1. 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.
2. 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.
3. Then we will look at the bug report, provide an answer and solution and reply to the user who reported it via e-mail.
4. 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

1. Get the following information of your system:
   1. Operating system
   2. Matlab version (use command 'ver' in Matlab to obtain it)
   3. COMKAT version
2. 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.

Known bugs and solutions

Download and installation

1. 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.
2. 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
3. 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

1. 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

1. 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.