AGAVE is a desktop application for viewing multichannel volume data. Several formats are supported, including OME-TIFF and Zeiss .czi files.
After cloning this repo, initialize the submodules, which contain a couple of dependency libraries:
git submodule update --init
Make sure you are in an environment where vsvarsall has been run, e.g. a "VS2022 x64 Native Tools Command Prompt"
tensorstore requires:
- Python 3.7 or later
- CMake 3.24 or later
- Perl, for building libaom from source (default). Must be in PATH. Not required if -DTENSORSTORE_USE_SYSTEM_LIBAOM=ON is specified.
- NASM, for building libjpeg-turbo, libaom, and dav1d from source (default). Must be in PATH.Not required if -DTENSORSTOREUSE_SYSTEM{JPEG,LIBAOM,DAV1D}=ON is specified.
- GNU Patch or equivalent. Must be in PATH.
A convenient way to install Perl, NASM, and GNU Patch is with chocolatey.
choco install strawberryperl nasm patch
Install Qt LTS 6.5.3. In your favorite Python virtual environment:
pip install aqtinstall
aqt install-qt --outputdir C:\Qt windows desktop 6.5.3 win64_msvc2019_64 -m qtwebsockets qtimageformats
Use vcpkg (must use target triplet x64-windows) to install the following:
vcpkg install spdlog glm zlib libjpeg-turbo liblzma tiff zstd eigen3 --triplet x64-windows
Build AGAVE
mkdir build
cd build
# (vs 2022)
cmake -DCMAKE_TOOLCHAIN_FILE=D:\vcpkg\scripts\buildsystems\vcpkg.cmake -G "Visual Studio 17 2022" -A x64 -DVCPKG_TARGET_TRIPLET=x64-windows ..
cmake --build .
You may need to adjust the vcpkg path depending on your configuration.
If you encounter issues during your build, check that all of your dependencies are installed and try again. You can also build to the INSTALL target with Visual Studio by opening the project solution (agave.sln
).
In your favorite Python virtual environment:
pip install aqtinstall
aqt install-qt --outputdir ~/Qt mac desktop 6.5.3 -m qtwebsockets qtimageformats
export Qt6_DIR=~/Qt/6.5.3/macos
# and then:
brew install spdlog glm libtiff nasm
mkdir build
cd build
cmake ..
make
# after make, you should have a runnable agave.app
# or, to build a redistributable bundle:
sudo make install
Install Qt 6.5.3 in your directory of choice and tell the build where to find it. In your favorite Python virtual environment:
pip install aqtinstall
aqt install-qt --outputdir ~/Qt linux desktop 6.5.3 -m qtwebsockets qtimageformats
# the next line is needed for CMake
export Qt6_DIR=~/Qt/6.5.3/gcc_64
- sudo apt install libtiff-dev
- sudo apt install libglm-dev
- sudo apt install libgl1-mesa-dev
- sudo apt install libegl1-mesa-dev
- sudo apt install libspdlog-dev
- sudo apt install nasm
mkdir build
cd build
cmake ..
make
If cmake fails please refer to the Dockerfile for a more complete list of Linux dependencies.
Use tbump (https://github.com/your-tools/tbump). See the tbump.toml file which shows all the files that contain necessary version info.
Just run
tbump major.minor.patch --dry-run
and if everything looks ok
tbump major.minor.patch
or, to do the git steps manually:
tbump major.minor.patch --only-patch