Frequently asked questions
- In order to make full use of DIPimage, what components of MATLAB are necessary?
- What versions of MATLAB will DIPimage run on?
- How do I use a DIPimage image object with an Image Processing Toolbox function?
- Can I have the source code?
- How do I integrate my C or C++ code into DIPimage?
- How do I select which watershed function to run?
I have found a bug. What do I do?
First make sure you have the latest version of DIPimage. Compare the version number shown in the GUI (or by
to that shown for the latest release in the releases page on GitHub.
Upgrade to the latest version if necessary and make sure the bug still exists. If the bug persists in this latest version,
do a cursory search in the project’s issues tracker. If you do find it there,
add a comment if you can provide additional information that will help us fix the bug. If you do not find it there,
submit a bug report.
As described in the file
CONTRIBUTING.md, please include
all the information you can that might help us reproduce the bug, especially the code that causes the bug.
In order to make full use of DIPimage, what components of MATLAB are necessary?
Just MATLAB itself. No other toolboxes are required, but of course can be used in conjunction.
What versions of MATLAB will DIPimage run on?
This toolbox requires MATLAB R2008a (version 7.6) or later. This is the version that introduced the
classdef-style objects, used in the core types of the toolbox. However, we have tested the toolbox only
under much newer versions of MATLAB, so your mileage may vary. Feel free to open a ticket to report issues
with your version of MATLAB.
How do I use a DIPimage image object with an Image Processing Toolbox function?
dip_array(im) will extract the MATLAB array from within the
im. No copies will
initially be made, unless the arrays are modified (read up on
MATLAB‘s lazy copying).
You can directly use MATLAB arrays in the DIPimage toolbox functions.
Can I have the source code?
Yes! Since DIPimage 3, the toolbox and the library it is built on are open source. You can find it on GitHub.
How do I integrate my C or C++ code into DIPimage?
See the section Writing MEX-files that use DIPlib.
How do I select which watershed function to run?
Several functions of DIPimage also exist in other MATLAB toolboxes (and presumably other 3rd party toolboxes).
MATLAB selects which version to run according to several rules. If you have added the DIPimage path at the top
of the MATLAB search path (with
addpath), then the DIPimage
watershed is the default.
If you like to use the Image Processing Toolbox function
watershed, you can do the following:
Change the order of paths in the search path. However, this means none of the DIPimage functions take precedence anymore. You do this by adding
addpathcommand (check with
Find out which
watershedfunctions are available (with
which watershed -all), and change to the right directory before calling
watershed. The function in the current directory is always selected over functions on the path.