Cancer Imaging Phenomics Toolkit (CaPTk)
1.9.0
|
Platform (x64) | Tested | Unsupported |
---|---|---|
Windows | 7, 8, 10 | XP, Vista |
Linux | Ubuntu 16.04, 18.04; Debian 9, CentOS 7 (source build) | Ubuntu 14.04; CentOS 6 |
macOS | 10.13, 10.14 | 10.12 |
Docker | N.A. | N.A. |
CaPTk has limited DICOM support. It only supports a limited protocols for MR, CT and MG modalities. DICOM loading has only been tested for images from UPenn. If you are not able to load your DICOM images, please open a new issue and send some anonymized DICOM images for us to test.
${CaPTk_InstallDir}/bin/CaPTk -h
Platform (x64) | Functionality | Successful Installation | Build From Source (after invoking "make install") | FUSE Issues (after invoking "--appimage-extract") |
---|---|---|---|---|
Windows | Generic | ${CaPTk_InstallDir}/bin/${ApplicationName}.exe -h | ${CaPTk_InstallDir}/bin/${ApplicationName}.exe -h | N.A. |
Linux | Generic | ${CaPTk_InstallDir}/bin/captk ${CaPTk_InstallDir}/bin/${ApplicationName}.cwl -h | ${CaPTk_InstallDir}/bin/${ApplicationName} -h | ~/CaPTk/${version}/${ApplicationName} -h |
macOS | Generic | ~/Applications/CaPTk_${version}.app/Contents/Resources/bin/${ApplicationName} -h | ${CaPTk_InstallDir}/bin/${ApplicationName} -h | N.A. |
Windows | FeatureExtraction | ${CaPTk_InstallDir}/bin/FeatureExtraction.exe -h | ${CaPTk_InstallDir}/bin/FeatureExtraction.exe -h | N.A. |
Linux | FeatureExtraction | ${CaPTk_InstallDir}/bin/captk FeatureExtraction.cwl -h | ${CaPTk_InstallDir}/bin/FeatureExtraction -h | ~/CaPTk/${version}/FeatureExtraction -h |
macOS | FeatureExtraction | ~/Applications/CaPTk_${version}.app/Contents/Resources/bin/FeatureExtraction -h | ${CaPTk_InstallDir}/bin/FeatureExtraction -h | N.A. |
sudo apt-add-repository ppa:oibaf/graphics-drivers && sudo apt-get update && sudo apt-get dist-upgrade
MESA_GL_VERSION_OVERRIDE=4.5 #put the opengl version you want to use here
This section highlights some of the common issues on Linux machines.
If the installer successfully finishes and you are not able to run CaPTk due to FUSE issues, please extract the installer using the following command to extract the contents of the AppImage onto the hard drive:
user@pc:~# ~/CaPTk/${version}/captk --appimage-extract
~/CaPTk/${version}/squashfs-root/usr/
with the binaries present in ~/CaPTk/${version}/squashfs-root/usr/bin
.~/CaPTk/${version}/squashfs-root/usr/lib
to their environment variable PATH: export PATH=~/CaPTk/${version}/squashfs-root/usr/bin:$PATH
~/CaPTk/${version}/squashfs-root/usr/lib
to their environment variable LD_LIBRARY_PATH: export LD_LIBRARY_PATH=~/CaPTk/${version}/squashfs-root/usr/lib:$LD_LIBRARY_PATH
.bashrc
, .cshrc
, .profile
, .kshrc
, etc.` for the settings to be persistent across login sessions.FeatureExtraction \ # the executable should already be in the $PATH -n AAC0_timestamp \ # this is the subject ID for this run -i /usr/path/T1.nii.gz,/usr/path/T2.nii.gz -t T1,T2 \ # the co-registered input image(s) and their respective modalities -m /user/path/mask.nii.gz \ # the mask file (co-registered with the input image(s) -r 2,4,5 -l ED,EN,NE \ # the labels from the mask file from where features need to be extracted and their respective label identifier(s) -p /usr/path/features.csv \ # the parameter file to use -o /usr/path/output.csv # the path to write the output
sudo add-apt-repository ppa:ubuntu-toolchain-r/test sudo apt-get update sudo apt-get install gcc-4.9 g++-4.9 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.9 60 --slave /usr/bin/g++ g++ /usr/bin/g++-4.9
sudo yum install centos-release-scl sudo yum install devtoolset-6
If you are running into mis-matched CXXABI
behavior with a message similar to:
libstdc++.so.6: version `CXXABI_1.3.8' not found (required by /lib/x86_64-linux-gnu/libGLU.so.1).
This means that you are running on a very new Linux distribution. Please see the discussion in https://github.com/CBICA/CaPTk/issues/1229 for details.
The minimum recommended resolution is 1200x1024. We have seen some visualization issues with high DPI (>2K) screens and bug reports related to it will be appreciated.
You can find all the builds in our Docker Hub repository: https://hub.docker.com/r/cbica/captk
docker run -it \ -v /tmp/.X11-unix:/tmp/.X11-unix \ -v $(pwd)/test:/app \ -e DISPLAY=$DISPLAY \ -u qtuser \ cbica/captk
Please see the Feature Extraction FAQ.
This is a well-known problem, documented in the following GitHub issues:
A possible solution is to revert the default GCC to version 5 using the following steps [ref]
echo "deb http://archive.ubuntu.com/ubuntu xenial main" | sudo tee /etc/apt/sources.list.d/xenial.list sudo apt-get update sudo update-alternatives --remove-all gcc sudo update-alternatives --remove-all g++ sudo apt-get install gcc-5 g++-5 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-5 10 sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-5 10
Please open a new issue with us and we will do our best to resolve it.