From 2c2e524912fa5f935cd8656188c8c84be20de58d Mon Sep 17 00:00:00 2001 From: MichaelSNelson Date: Thu, 1 Feb 2024 19:23:03 -0600 Subject: [PATCH] Initial functioning commit for QP 0.5.0 --- .github/workflows/gradle.yml | 42 ++ .github/workflows/release.yml | 33 + .gitignore | 65 +- README.md | 117 +++- build.gradle | 172 +++++ gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 60756 bytes gradle/wrapper/gradle-wrapper.properties | 5 + gradlew | 240 +++++++ gradlew.bat | 91 +++ qupath-intellij.png | Bin 0 -> 82535 bytes settings.gradle | 45 ++ .../BasicStitchingExtension.groovy | 61 ++ .../functions/StitchingGUI.groovy | 405 +++++++++++ .../stitching/StitchingImplementations.groovy | 650 ++++++++++++++++++ .../utilities/UtilityFunctions.groovy | 131 ++++ .../qupath.lib.gui.extensions.QuPathExtension | 1 + 16 files changed, 2032 insertions(+), 26 deletions(-) create mode 100644 .github/workflows/gradle.yml create mode 100644 .github/workflows/release.yml create mode 100644 build.gradle create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100644 gradlew create mode 100644 gradlew.bat create mode 100644 qupath-intellij.png create mode 100644 settings.gradle create mode 100644 src/main/groovy/qupath/ext/basicstitching/BasicStitchingExtension.groovy create mode 100644 src/main/groovy/qupath/ext/basicstitching/functions/StitchingGUI.groovy create mode 100644 src/main/groovy/qupath/ext/basicstitching/stitching/StitchingImplementations.groovy create mode 100644 src/main/groovy/qupath/ext/basicstitching/utilities/UtilityFunctions.groovy create mode 100644 src/main/resources/META-INF/services/qupath.lib.gui.extensions.QuPathExtension diff --git a/.github/workflows/gradle.yml b/.github/workflows/gradle.yml new file mode 100644 index 0000000..2a01281 --- /dev/null +++ b/.github/workflows/gradle.yml @@ -0,0 +1,42 @@ +# This workflow uses actions that are not certified by GitHub. +# They are provided by a third-party and are governed by +# separate terms of service, privacy policy, and support +# documentation. +# This workflow will build a Java project with Gradle and cache/restore any dependencies to improve the workflow execution time +# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-java-with-gradle + +name: Java CI with Gradle + +on: + push: + branches: [ "main" ] + pull_request: + branches: [ "main" ] + workflow_dispatch: + +permissions: + contents: read + +jobs: + build: + + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v3 + - name: Set up JDK 17 # TODO: check Java version + uses: actions/setup-java@v3 + with: + java-version: '17' + distribution: 'temurin' + - name: Validate Gradle wrapper + uses: gradle/wrapper-validation-action@e6e38bacfdf1a337459f332974bb2327a31aaf4b + - name: Build with Gradle + uses: gradle/gradle-build-action@67421db6bd0bf253fb4bd25b31ebb98943c375e1 + with: + arguments: build + - uses: actions/upload-artifact@v3 + with: + name: jar + path: build/libs + retention-days: 7 diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml new file mode 100644 index 0000000..8057f78 --- /dev/null +++ b/.github/workflows/release.yml @@ -0,0 +1,33 @@ +name: Make draft release + +on: + push: + tags: ["v*"] + workflow_dispatch: + +jobs: + release: + permissions: + contents: write + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v3 + - name: Define version env variable + run: | + echo "VERSION=$(echo ${{ github.ref_name }} | sed -r 's/v([0-9]+\.[0-9]+\.?[0-9]?)/\1/'" >> $GITHUB_ENV + - name: Set up JDK 17 + uses: actions/setup-java@v3 + with: + java-version: '17' + distribution: 'temurin' + - name: Validate Gradle wrapper + uses: gradle/wrapper-validation-action@v1.1.0 + - name: Build with Gradle + uses: gradle/gradle-build-action@v2.7.1 + with: + arguments: build -Pversion=$VERSION + - name: Release + env: + GH_TOKEN: ${{ github.token }} + run: gh release create --draft ${{ github.ref_name }} --title ${{ github.ref_name }} build/libs/* diff --git a/.gitignore b/.gitignore index 524f096..66258b1 100644 --- a/.gitignore +++ b/.gitignore @@ -1,24 +1,41 @@ -# Compiled class file -*.class - -# Log file -*.log - -# BlueJ files -*.ctxt - -# Mobile Tools for Java (J2ME) -.mtj.tmp/ - -# Package Files # -*.jar -*.war -*.nar -*.ear -*.zip -*.tar.gz -*.rar - -# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml -hs_err_pid* -replay_pid* +# Javadocs +docs/ + +# Maven +deploy/ +target/ +log/ + +# IntelliJ +.idea/ +*.iml +out/ + +# Gradle +# Use local properties (e.g. to set a specific JDK) +gradle.properties +build/ +.gradle/ +gradle.properties + +# Eclipse +.settings/ +.project +.classpath + +# VSCode +.vscode/ + +# Mac +.DS_Store + +# Java +hs_err*.log + +# Other +*.tmp +*.bak +*.swp +*~.nib +*thumbs.db +bin/ diff --git a/README.md b/README.md index 2ec3405..41ee83c 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,115 @@ -# basic-stitching -Based on QuPath extension template - for basic tiling with no overlap resolution +# QuPath extension template + +This repo contains a template and instructions to help create a new extension for [QuPath](https://qupath.github.io). + +It already contains two minimal extensions, so the first task is to make sure that they work. +Then, it's a matter of customizing the code to make it more useful. + +> There are two extensions to show that you can use either Java or Groovy. + +## Build the extension + +Building the extension with Gradle should be pretty easy - you don't even need to install Gradle separately, because the +[Gradle Wrapper](https://docs.gradle.org/current/userguide/gradle_wrapper.html) will take care of that. + +Open a command prompt, navigate to where the code lives, and use +```bash +gradlew build +``` + +The built extension should be found inside `build/libs`. +You can drag this onto QuPath to install it. +You'll be prompted to create a user directory if you don't already have one. + +The minimal extension here doesn't do much, but it should at least install a new command under the 'Extensions' menu in +QuPath. + +> In case your extension contains external dependencies beyond what QuPath already includes, you can create a +> [single jar file](https://imperceptiblethoughts.com/shadow/introduction/#benefits-of-shadow) that bundles these along +> with your extension by using +> ```bash +> gradlew shadowJar +> ``` +> If you don't do that, you'll need to drag *all* the extra dependences onto QuPath to install them as well. + + +## Set up in an IDE (optional) + +During development, things are likely to be much easier if you work within an IDE. + +QuPath itself is developed using IntelliJ, and you can import the extension template there. + +However, for development and testing, it can help to import QuPath *and* the extension and have them in your IDE side-by-side. + +In IntelliJ, you can do this in a few steps: +* Get QuPath's source code, as described at https://qupath.readthedocs.io/en/0.4/docs/reference/building.html +* Store your extension code in a directory *beside* QuPath's code. So it should be located next to the `qupath` code directory. +* Import QuPath into IntelliJ as a Gradle project (you don't need to import the extension yet!) + * See https://www.jetbrains.com/help/idea/work-with-gradle-projects.html +* Within `qupath/settings.gradle` add the line `includeFlat 'your-extension-code-directory'` (updating the code directory as needed) +* Refresh the Gradle project in IntelliJ, and your extension code should appear +* Create a [Run configuration](https://www.jetbrains.com/help/idea/run-debug-configuration.html) in IntelliJ to launch QuPath. An example of how that looks is shown below: + +QuPath run configuration in IntelliJ + +Now when you run QuPath from IntelliJ, your extension should (hopefully) be found - there's no need to add it by drag & drop. + +## Customize the extension + +There are a few fixed steps to customizing the extension, and then the main creative part where you add your own code. + +### Update `settings.gradle` + +Open `settings.gradle` and check the comment lines flagged with `\\TODO`. +These point you towards parts you may well need to change. + +### Update `build.gradle` + +Open `build.gradle` and follow a similar process to with `settings.gradle`, to update the bits flagged with `\\TODO`. + +### Create the extension Java or Groovy file(s) + +For the extension to work, you need to create at least one file that extends `qupath.lib.gui.extensions.QuPathExtension`. + +There are two examples in the template, in two languages: +* **Java:** `qupath.ext.template.DemoExtension.java`. +* **Groovy:** `qupath.ext.template.DemoGroovyExtension.java`. + +You can pick the one that corresponds to the language you want to use, and delete the other. + +Then take your chosen file and rename it, edit it, move it to another package... basically, make it your own. + +> Please **don't neglect this step!** +> If you do, there's a chance of multiple extensions being created with the same class names... and causing confusion later. + +### Update the `META-INF/services` file + +For QuPath to *find* the extension later, the full class name needs to be available in `resources/META-INFO/services/qupath.lib.gui.extensions.QuPathExtensions`. + +So remember to edit that file to include the class name that you actually used for your extension. + +### Specify your license + +Add a license file to your GitHub repo so that others know what they can and can't do with your extension. + +This should be compatible with QuPath's license -- see https://github.com/qupath/qupath + +### Replace this readme + +Don't forget to replace the contents of this readme with your own! + + +## Getting help + +For questions about QuPath and/or creating new extensions, please use the forum at https://forum.image.sc/tag/qupath + +------ + +## License + +This is just a template, you're free to use it however you like. +You can treat the contents of *this repository only* as being under [the Unlicense](https://unlicense.org) (except for the Gradle wrapper, which has its own license included). + +If you use it to create a new QuPath extension, I'd strongly encourage you to select a suitable open-source license for the extension. + +Note that *QuPath itself* is available under the GPL, so you do have to abide by those terms: see https://github.com/qupath/qupath for more. diff --git a/build.gradle b/build.gradle new file mode 100644 index 0000000..d1edea2 --- /dev/null +++ b/build.gradle @@ -0,0 +1,172 @@ +plugins { + // Main gradle plugin for building a Java library + id 'java-library' + // Support writing the extension in Groovy (remove this if you don't want to) + id 'groovy' + // To create a shadow/fat jar that bundle up all dependencies + id 'com.github.johnrengelman.shadow' version '8.1.1' + // Include this plugin to avoid downloading JavaCPP dependencies for all platforms + id 'org.bytedeco.gradle-javacpp-platform' + id 'org.openjfx.javafxplugin' version '0.1.0' + id 'maven-publish' +} + + +ext.moduleName = 'qupath.extension.basic-stitching' +group = 'qupath.ext.basicstitching' + +base { + archivesName = rootProject.name + version = '0.2.0' + description = 'Provides basic tiling, no overlap resolution yet.' +} + + +// The default 'gradle.ext.qupathVersion' reads this from settings.gradle. +ext.qupathVersion = gradle.ext.qupathVersion + + +// Should be Java 17 for QuPath v0.5.0 +ext.qupathJavaVersion = 17 + +/** + * Define dependencies. + * - Using 'shadow' indicates that they are already part of QuPath, so you don't need + * to include them in your extension. If creating a single 'shadow jar' containing your + * extension and all dependencies, these won't be added. + * - Using 'implementation' indicates that you need the dependency for the extension to work, + * and it isn't part of QuPath already. If you are creating a single 'shadow jar', the + * dependency should be bundled up in the extension. + * - Using 'testImplementation' indicates that the dependency is only needed for testing, + * but shouldn't be bundled up for use in the extension. + */ +dependencies { + + // Main QuPath user interface jar. + // Automatically includes other QuPath jars as subdependencies. + shadow "io.github.qupath:qupath-gui-fx:${qupathVersion}" + + // For logging - the version comes from QuPath's version catalog at + // https://github.com/qupath/qupath/blob/main/gradle/libs.versions.toml + // See https://docs.gradle.org/current/userguide/platforms.html + shadow libs.slf4j + + // If you aren't using Groovy, this can be removed + shadow libs.bundles.groovy + + testImplementation "io.github.qupath:qupath-gui-fx:${qupathVersion}" + testImplementation libs.junit + implementation "io.github.qupath:qupath-extension-bioformats:${qupathVersion}" +} + +/* + * Manifest info + */ +jar { + manifest { + attributes("Implementation-Title": project.name, + "Implementation-Version": archiveVersion, + "Automatic-Module-Name": moduleName) + } +} + +/** + * Copy necessary attributes, see + * - https://github.com/qupath/qupath-extension-template/issues/9 + * - https://github.com/openjfx/javafx-gradle-plugin#variants + */ +configurations.shadow { + def runtimeAttributes = configurations.runtimeClasspath.attributes + runtimeAttributes.keySet().each { key -> + if (key in [Usage.USAGE_ATTRIBUTE, OperatingSystemFamily.OPERATING_SYSTEM_ATTRIBUTE, MachineArchitecture.ARCHITECTURE_ATTRIBUTE]) + attributes.attribute(key, runtimeAttributes.getAttribute(key)) + } +} + +/* + * Copy the LICENSE file into the jar... if we have one (we should!) + */ +processResources { + from ("${projectDir}/LICENSE") { + into 'licenses/' + } +} + +/* + * Define extra 'copyDependencies' task to copy dependencies into the build directory. + */ +tasks.register("copyDependencies", Copy) { + description "Copy dependencies into the build directory for use elsewhere" + group "QuPath" + + from configurations.default + into 'build/libs' +} + +/* + * Ensure Java 17 compatibility, and include sources and javadocs when building. + */ +java { + toolchain { + languageVersion = JavaLanguageVersion.of(qupathJavaVersion) + } + withSourcesJar() + withJavadocJar() +} + +/* + * Create javadocs for all modules/packages in one place. + * Use -PstrictJavadoc=true to fail on error with doclint (which is rather strict). + */ +tasks.withType(Javadoc) { + options.encoding = 'UTF-8' + def strictJavadoc = findProperty('strictJavadoc') + if (!strictJavadoc) { + options.addStringOption('Xdoclint:none', '-quiet') + } +} + +/* + * Specify that the encoding should be UTF-8 for source files + */ +tasks.named('compileJava') { + options.encoding = 'UTF-8' +} + +/* + * Avoid 'Entry .gitkeep is a duplicate but no duplicate handling strategy has been set.' + * when using withSourcesJar() + */ +tasks.withType(org.gradle.jvm.tasks.Jar) { + duplicatesStrategy = DuplicatesStrategy.INCLUDE +} + +/* + * Support tests with JUnit. + */ +tasks.named('test') { + useJUnitPlatform() +} + +// Looks redundant to include this here and in settings.gradle, +// but helps overcome some gradle trouble when including this as a subproject +// within QuPath itself (which is useful during development). +repositories { + // Add this if you need access to dependencies only installed locally + // mavenLocal() + + mavenCentral() + + // Add scijava - which is where QuPath's jars are hosted + maven { + url "https://maven.scijava.org/content/groups/public" + } +} + +publishing { + publications { + myLibrary(MavenPublication) { + from components.java + } + } +} diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..249e5832f090a2944b7473328c07c9755baa3196 GIT binary patch literal 60756 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 '} + case $link in #( + /*) app_path=$link ;; #( + *) app_path=$APP_HOME$link ;; + esac +done + +APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit + +APP_NAME="Gradle" +APP_BASE_NAME=${0##*/} + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + ulimit -n "$MAX_FD" || + warn "Could not set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, stacking in reverse order: +# * args from the command line +# * the main class name +# * -classpath +# * -D...appname settings +# * --module-path (only if needed) +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables. + +# For Cygwin or MSYS, switch paths to Windows format before running java +if "$cygwin" || "$msys" ; then + APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) + CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" ) + + JAVACMD=$( cygpath --unix "$JAVACMD" ) + + # Now convert the arguments - kludge to limit ourselves to /bin/sh + for arg do + if + case $arg in #( + -*) false ;; # don't mess with options #( + /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath + [ -e "$t" ] ;; #( + *) false ;; + esac + then + arg=$( cygpath --path --ignore --mixed "$arg" ) + fi + # Roll the args list around exactly as many times as the number of + # args, so each arg winds up back in the position where it started, but + # possibly modified. + # + # NB: a `for` loop captures its iteration list before it begins, so + # changing the positional parameters here affects neither the number of + # iterations, nor the values presented in `arg`. + shift # remove old arg + set -- "$@" "$arg" # push replacement arg + done +fi + +# Collect all arguments for the java command; +# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of +# shell script including quotes and variable substitutions, so put them in +# double quotes to make sure that they get re-expanded; and +# * put everything else in single quotes, so that it's not re-expanded. + +set -- \ + "-Dorg.gradle.appname=$APP_BASE_NAME" \ + -classpath "$CLASSPATH" \ + org.gradle.wrapper.GradleWrapperMain \ + "$@" + +# Stop when "xargs" is not available. +if ! command -v xargs >/dev/null 2>&1 +then + die "xargs is not available" +fi + +# Use "xargs" to parse quoted args. +# +# With -n1 it outputs one arg per line, with the quotes and backslashes removed. +# +# In Bash we could simply go: +# +# readarray ARGS < <( xargs -n1 <<<"$var" ) && +# set -- "${ARGS[@]}" "$@" +# +# but POSIX shell has neither arrays nor command substitution, so instead we +# post-process each arg (as a line of input to sed) to backslash-escape any +# character that might be a shell metacharacter, then use eval to reverse +# that process (while maintaining the separation between arguments), and wrap +# the whole thing up as a single "set" statement. +# +# This will of course break if any of these variables contains a newline or +# an unmatched quote. +# + +eval "set -- $( + printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" | + xargs -n1 | + sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' | + tr '\n' ' ' + )" '"$@"' + +exec "$JAVACMD" "$@" diff --git a/gradlew.bat b/gradlew.bat new file mode 100644 index 0000000..f127cfd --- /dev/null +++ b/gradlew.bat @@ -0,0 +1,91 @@ +@rem +@rem Copyright 2015 the original author or authors. +@rem +@rem Licensed under the Apache License, Version 2.0 (the "License"); +@rem you may not use this file except in compliance with the License. +@rem You may obtain a copy of the License at +@rem +@rem https://www.apache.org/licenses/LICENSE-2.0 +@rem +@rem Unless required by applicable law or agreed to in writing, software +@rem distributed under the License is distributed on an "AS IS" BASIS, +@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +@rem See the License for the specific language governing permissions and +@rem limitations under the License. +@rem + +@if "%DEBUG%"=="" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%"=="" set DIRNAME=. +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if %ERRORLEVEL% equ 0 goto execute + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* + +:end +@rem End local scope for the variables with windows NT shell +if %ERRORLEVEL% equ 0 goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +set EXIT_CODE=%ERRORLEVEL% +if %EXIT_CODE% equ 0 set EXIT_CODE=1 +if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE% +exit /b %EXIT_CODE% + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/qupath-intellij.png b/qupath-intellij.png new file mode 100644 index 0000000000000000000000000000000000000000..bcbd52660dacae9679e03d243c9e857f7b25a640 GIT binary patch literal 82535 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 literal 0 HcmV?d00001 diff --git a/settings.gradle b/settings.gradle new file mode 100644 index 0000000..c439a40 --- /dev/null +++ b/settings.gradle @@ -0,0 +1,45 @@ +pluginManagement { + plugins { + // Gradle is awkward about declaring versions for plugins + // Specifying it here, rather than build.gradle, makes it possible + // to include the extension as a subproject of QuPath itself + // (which is useful during development) + id 'org.bytedeco.gradle-javacpp-platform' version '1.5.9' + } +} + + +rootProject.name = 'basic-stitching' + + +// Note that the QuPath API isn't stable; something designed for +// 0.X.a should work with 0.X.b, but not necessarily with 0.Y.a. +gradle.ext.qupathVersion = "0.5.0" + +dependencyResolutionManagement { + + // Access QuPath's version catalog for dependency versions + versionCatalogs { + libs { + from("io.github.qupath:qupath-catalog:${gradle.ext.qupathVersion}") + } + } + + repositories { + + mavenCentral() + + // Add scijava - which is where QuPath's jars are + maven { + url "https://maven.scijava.org/content/groups/public" + } + maven { + url "https://maven.scijava.org/content/repositories/releases" + } + + maven { + url "https://maven.scijava.org/content/repositories/snapshots" + } + + } +} diff --git a/src/main/groovy/qupath/ext/basicstitching/BasicStitchingExtension.groovy b/src/main/groovy/qupath/ext/basicstitching/BasicStitchingExtension.groovy new file mode 100644 index 0000000..113ee55 --- /dev/null +++ b/src/main/groovy/qupath/ext/basicstitching/BasicStitchingExtension.groovy @@ -0,0 +1,61 @@ +package qupath.ext.basicstitching + +import javafx.scene.control.MenuItem +import qupath.ext.basicstitching.functions.StitchingGUI +import qupath.lib.common.Version +import qupath.lib.gui.QuPathGUI +import qupath.lib.gui.extensions.QuPathExtension + +/** + TODO: create public functions so that stitching can be run from command line or a script + CHECK: Always build AND publish to maven local for use with qp-scope + ./gradlew publishToMavenLocal + + */ +class BasicStitchingExtension implements QuPathExtension { + + // Setting the variables here is enough for them to be available in the extension + String name = "Basic stitching" + String description = "Basic stitching extension that puts tiles together into pyramidal ome.tif files, no overlap resolution or flat field correction." + Version QuPathVersion = Version.parse("v0.5.0") + +// @Override +// void installExtension(QuPathGUI qupath) { +// qupath.installActions(ActionTools.getAnnotatedActions(new BSCommands(qupath))) +// addMenuItem(qupath) +// } + @Override + void installExtension(QuPathGUI qupath) { + addMenuItem(qupath) + } + /** + * Get the description of the extension. + * + * @return The description of the extension. + */ + @Override + public String getDescription() { + return "Stitch tiles into a pyramidal ome.tif"; + } + + /** + * Get the name of the extension. + * + * @return The name of the extension. + */ + @Override + public String getName() { + return "BasicStitching"; + } + + private void addMenuItem(QuPathGUI qupath) { + def menu = qupath.getMenu("Extensions>${name}", true) + def fileNameStitching = new MenuItem("Basic Stitching Extension") + fileNameStitching.setOnAction(e -> { + StitchingGUI.createGUI() + + }) + menu.getItems() << fileNameStitching + } + +} diff --git a/src/main/groovy/qupath/ext/basicstitching/functions/StitchingGUI.groovy b/src/main/groovy/qupath/ext/basicstitching/functions/StitchingGUI.groovy new file mode 100644 index 0000000..bd728b0 --- /dev/null +++ b/src/main/groovy/qupath/ext/basicstitching/functions/StitchingGUI.groovy @@ -0,0 +1,405 @@ +// TODO Progress bar for stitching +// TODO Estimate size of stitched image to predict necessary memory +// Warn user if size exceeds QuPath's allowed limits. + +package qupath.ext.basicstitching.functions + +import javafx.scene.Node +import javafx.scene.control.* +import javafx.scene.layout.GridPane +import javafx.stage.DirectoryChooser +import javafx.stage.Modality +import org.slf4j.Logger +import org.slf4j.LoggerFactory +import qupath.ext.basicstitching.stitching.StitchingImplementations +import qupath.lib.gui.scripting.QPEx + +import java.awt.* + +import static qupath.ext.basicstitching.utilities.UtilityFunctions.getCompressionTypeList + +class StitchingGUI { + + private static final Logger logger = LoggerFactory.getLogger(StitchingGUI.class); + static TextField folderField = new TextField(); + static ComboBox compressionBox = new ComboBox<>(); + static TextField pixelSizeField = new TextField("0.4988466"); + static TextField downsampleField = new TextField("1"); + static TextField matchStringField = new TextField("20x"); + static ComboBox stitchingGridBox = new ComboBox<>(); // New combo box for stitching grid options + static Button folderButton = new Button("Select Folder"); + // Declare labels as static fields + static Label stitchingGridLabel = new Label("Stitching Method:"); + static Label folderLabel = new Label("Folder location:"); + static Label compressionLabel = new Label("Compression type:"); + static Label pixelSizeLabel = new Label("Pixel size, microns:"); + static Label downsampleLabel = new Label("Downsample:"); + static Label matchStringLabel = new Label("Stitch sub-folders with text string:"); + static Hyperlink githubLink = new Hyperlink("GitHub ReadMe"); + + // Map to hold the positions of each GUI element + private static Map guiElementPositions = new HashMap<>(); + + + static void createGUI() { + // Create the dialog + def dlg = new Dialog() + dlg.initModality(Modality.APPLICATION_MODAL) + dlg.setTitle("Input Stitching Method and Options") + dlg.setHeaderText("Enter your settings below:") + + // Set the content + dlg.getDialogPane().setContent(createContent()) + + // Add Okay and Cancel buttons + dlg.getDialogPane().getButtonTypes().addAll(ButtonType.OK, ButtonType.CANCEL) + + // Show the dialog and capture the response + def result = dlg.showAndWait() + + // Handling the response + if (result.isPresent() && result.get() == ButtonType.OK) { + String folderPath = folderField.getText() // Assuming folderField is accessible + String compressionType = compressionBox.getValue() // Assuming compressionBox is accessible + + // Check if pixelSizeField and downsampleField are not empty + double pixelSize = pixelSizeField.getText() ? Double.parseDouble(pixelSizeField.getText()) : 0 + // Default to 0 if empty + double downsample = downsampleField.getText() ? Double.parseDouble(downsampleField.getText()) : 1 + // Default to 1 if empty + + String matchingString = matchStringField.getText() // Assuming matchStringField is accessible + String stitchingType = stitchingGridBox.getValue() + // Call the function with collected data + String finalImageName = StitchingImplementations.stitchCore(stitchingType, folderPath, folderPath, compressionType, pixelSize, downsample, matchingString) + //stitchByFileName(folderPath, compressionType, pixelSize, downsample, matchingString) + } + + } + +/** + * Creates and returns a GridPane containing all the components for the GUI. + * This method initializes the positions of each component in the grid, + * adds the components to the grid, and sets their initial visibility. + * + * @return A GridPane containing all the configured components. + */ + private static GridPane createContent() { + // Create a new GridPane for layout + GridPane pane = new GridPane(); + + // Set horizontal and vertical gaps between grid cells + pane.setHgap(10); + pane.setVgap(10); + + // Initialize the positions of each component in the grid + initializePositions(); + + // Add various components to the grid pane + // Each method call below corresponds to a specific component or a group of components + addStitchingGridComponents(pane); // Adds a combo box for selecting the stitching method + addFolderSelectionComponents(pane); // Adds components for selecting the folder location + addMatchStringComponents(pane); // Adds a text field for entering the matching string + addCompressionComponents(pane); // Adds a combo box for selecting the compression type + addPixelSizeComponents(pane); // Adds a text field for entering the pixel size + addDownsampleComponents(pane); // Adds a text field for entering the downsample value + + // Add a hyperlink to the GitHub repository at the bottom of the pane + addGitHubLinkComponent(pane); + + // Update the components' visibility based on the current selection in the stitching method combo box + updateComponentsBasedOnSelection(pane); + + // Return the fully configured GridPane + return pane; + } + + +/** + * Adds a label and its associated control to the specified GridPane. + * The method uses the guiElementPositions map to determine the correct + * row index for the label and control in the grid. If the row index is + * not found, an error is logged. + * + * @param pane The GridPane to which the label and control are added. + * @param label The label to be added to the grid. + * @param control The control (e.g., TextField, ComboBox) associated with the label. + */ + private static void addToGrid(GridPane pane, Node label, Node control) { + // Retrieve the row index for the label from the guiElementPositions map + Integer rowIndex = guiElementPositions.get(label); + + // Check if the row index was found + if (rowIndex != null) { + // Add the label and control to the grid at the specified row index + pane.add(label, 0, rowIndex); // Add label to column 0 + pane.add(control, 1, rowIndex); // Add control to column 1 + } else { + // Log an error if the row index is not found + logger.error("Row index not found for component: " + label); + } + } + +/** + * Adds a GitHub repository hyperlink to the GridPane. The hyperlink is configured to open + * the GitHub page in the default web browser when clicked. The position of the hyperlink in the + * GridPane is determined based on its predefined row index in the guiElementPositions map. + * + * @param pane The GridPane to which the GitHub hyperlink is to be added. + */ + private static void addGitHubLinkComponent(GridPane pane) { + // Set up the action on the hyperlink to open the GitHub repository URL + // in the user's default web browser when clicked. + githubLink.setOnAction(e -> { + try { + // Open the GitHub repository URL + Desktop.getDesktop().browse(new URI("https://github.com/MichaelSNelson/BasicStitching")); + } catch (Exception ex) { + // Log any error encountered while trying to open the URL + logger.error("Error opening link", ex); + } + }); + + // Retrieve the pre-defined row index for the hyperlink from the guiElementPositions map. + // This determines where the hyperlink will be placed in the GridPane. + Integer rowIndex = guiElementPositions.get(githubLink); + + // Add the hyperlink to the specified row in the GridPane, spanning across 2 columns. + pane.add(githubLink, 0, rowIndex, 2, 1); + } + + +/** + * Initializes the positions of GUI elements in the GridPane. This method assigns a unique + * row index to each GUI element by incrementally increasing a position counter. The positions + * are stored in the guiElementPositions map, which maps each GUI element (Node) to its row index + * in the GridPane. + */ + private static void initializePositions() { + // Start with a position counter at 0. + int currentPosition = 0; + + // Dynamically assign row positions to each GUI element. + // The order of these statements dictates their vertical order in the GridPane. + + guiElementPositions.put(stitchingGridLabel, currentPosition++); + // Position for stitching grid label and combo box + guiElementPositions.put(folderLabel, currentPosition++); // Position for folder label and text field + guiElementPositions.put(compressionLabel, currentPosition++); // Position for compression label and combo box + guiElementPositions.put(pixelSizeLabel, currentPosition++); // Position for pixel size label and text field + guiElementPositions.put(downsampleLabel, currentPosition++); // Position for downsample label and text field + guiElementPositions.put(matchStringLabel, currentPosition++); + // Position for matching string label and text field + guiElementPositions.put(githubLink, currentPosition++); // Position for the GitHub hyperlink + + // More components can be added here following the same pattern. + } + + +/** + * Adds stitching grid components to the specified GridPane. This method configures a combo box + * for selecting the stitching method and adds it along with its label to the GridPane. + * It clears any existing items in the combo box and adds a predefined set of stitching options. + * The default stitching method is set, and an action is defined to update component visibility + * based on the selected stitching method. + * + * @param pane The GridPane to which the stitching grid components are to be added. + */ + private static void addStitchingGridComponents(GridPane pane) { + // Clear any existing items in the combo box to avoid duplicates + stitchingGridBox.getItems().clear(); + + // Add a set of predefined stitching options to the combo box + stitchingGridBox.getItems().addAll( + "Vectra tiles with metadata", + "Filename[x,y] with coordinates in microns", + "Coordinates in TileConfiguration.txt file" + ); + + // Set the default value for the combo box + stitchingGridBox.setValue("Coordinates in TileConfiguration.txt file"); + + // Define an action to be performed when a new item is selected in the combo box + // This action updates the visibility of other components based on the selection + stitchingGridBox.setOnAction(e -> updateComponentsBasedOnSelection(pane)); + + // Add the stitching method label and the combo box to the GridPane + // using the addToGrid helper method + addToGrid(pane, stitchingGridLabel as Node, stitchingGridBox as Node); + } + + +/** + * Adds components for folder selection to the specified GridPane. This method configures a text field + * for displaying the selected folder path and a button to open a directory chooser dialog. + * It attempts to set a default folder path and defines the action for the button to select a folder. + * The text field and the button are added to the GridPane in their designated positions. + * + * @param pane The GridPane to which the folder selection components are to be added. + */ + private static void addFolderSelectionComponents(GridPane pane) { + // Attempt to initialize the folder path text field with a default path + try { + String defaultFolderPath = QPEx.buildPathInProject("Tiles"); + logger.info("Default folder path: {}", defaultFolderPath); + folderField.setText(defaultFolderPath); + } catch (Exception e) { + // If the default path cannot be set, probably due to no project being open + logger.info("Error setting default folder path, usually due to no project being open", e); + } + + // Configure the action for the folder selection button + folderButton.setOnAction(e -> { + try { + DirectoryChooser dirChooser = new DirectoryChooser(); + dirChooser.setTitle("Select Folder"); + + // Get the initial directory path from the text field + String initialDirPath = folderField.getText(); + File initialDir = new File(initialDirPath); + + // Set the initial directory in the directory chooser if it exists + if (initialDir.exists() && initialDir.isDirectory()) { + dirChooser.setInitialDirectory(initialDir); + } else { + logger.warn("Initial directory does not exist or is not a directory: {}", initialDir.getAbsolutePath()); + } + + // Show the directory chooser dialog and update the text field with the selected directory + File selectedDir = dirChooser.showDialog(null); // Replace null with your stage if available + if (selectedDir != null) { + folderField.setText(selectedDir.getAbsolutePath()); + logger.info("Selected folder path: {}", selectedDir.getAbsolutePath()); + } + } catch (Exception ex) { + // Log an error if there is an issue during folder selection + logger.error("Error selecting folder", ex); + } + }); + + // Add the folder label and text field to the GridPane + addToGrid(pane, folderLabel as Node, folderField as Node); + + // Retrieve the row index for placing the folder button and add it to the GridPane + Integer rowIndex = guiElementPositions.get(folderLabel); + if (rowIndex != null) { + pane.add(folderButton, 2, rowIndex); // Place the button next to the text field + } else { + // Log an error if the row index for the folder button is not found + logger.error("Row index not found for folderButton"); + } + } + +//TODO populate with a list of compression types +/** + * Adds compression selection components to the specified GridPane. + * This method configures a combo box with options for different types of image compression + * and adds it to the grid along with a label. A tooltip is also set for the label and + * the combo box to provide additional information to the user. + * + * @param pane The GridPane to which the compression components are to be added. + */ + private static void addCompressionComponents(GridPane pane) { + // Clear any existing items and add new compression options to the combo box + def compressionTypes = getCompressionTypeList() + compressionBox.getItems().clear(); + compressionBox.getItems().addAll(compressionTypes); + + // Set the default value for the combo box + compressionBox.setValue("J2K_LOSSY"); + + // Create and set a tooltip for additional information + Tooltip compressionTooltip = new Tooltip("Select the type of image compression."); + compressionLabel.setTooltip(compressionTooltip); + compressionBox.setTooltip(compressionTooltip); + + // Add the compression label and combo box to the GridPane + addToGrid(pane, compressionLabel as Node, compressionBox as Node); + } + + +/** + * Adds pixel size input components to the specified GridPane. + * This method adds a label and a text field for entering the pixel size to the grid. + * + * @param pane The GridPane to which the pixel size components are to be added. + */ + private static void addPixelSizeComponents(GridPane pane) { + // Add the pixel size label and text field to the GridPane + addToGrid(pane, pixelSizeLabel as Node, pixelSizeField as Node); + } + + +/** + * Adds downsample input components to the specified GridPane. + * This method adds a label and a text field for entering the downsample value to the grid. + * A tooltip is also set for the label and the text field to provide additional information. + * + * @param pane The GridPane to which the downsample components are to be added. + */ + private static void addDownsampleComponents(GridPane pane) { + // Create and set a tooltip for additional information + Tooltip downsampleTooltip = new Tooltip("The amount by which the highest resolution plane will be initially downsampled."); + downsampleLabel.setTooltip(downsampleTooltip); + downsampleField.setTooltip(downsampleTooltip); + + // Add the downsample label and text field to the GridPane + addToGrid(pane, downsampleLabel as Node, downsampleField as Node); + } + + +/** + * Adds matching string input components to the specified GridPane. + * This method adds a label and a text field for entering the matching string to the grid. + * + * @param pane The GridPane to which the matching string components are to be added. + */ + private static void addMatchStringComponents(GridPane pane) { + // Add the matching string label and text field to the GridPane + addToGrid(pane, matchStringLabel as Node, matchStringField as Node); + } + + +/** + * Updates the visibility of certain GUI components based on the current selection + * in the stitching method combo box. Specifically, it hides or shows the pixel size + * field and label based on the selected stitching method. + * + * @param pane The GridPane containing the components to be updated. + */ + private static void updateComponentsBasedOnSelection(GridPane pane) { + // Determine whether to hide the pixel size field and label + boolean hidePixelSize = stitchingGridBox.getValue().equals("Vectra multiplex tif") || + stitchingGridBox.getValue().equals("Coordinates in TileCoordinates.txt file"); + pixelSizeLabel.setVisible(!hidePixelSize); + pixelSizeField.setVisible(!hidePixelSize); + + // Adjust the layout of the GridPane to reflect the visibility changes + adjustLayout(pane); + } + + +/** + * Adjusts the layout of the GridPane based on the current positions specified in the guiElementPositions map. + * This method iterates through each GUI element in the map and updates its row index in the GridPane. + * The adjustment ensures that the GUI elements are displayed in the correct order and position, + * especially after any visibility changes. + * + * @param pane The GridPane whose layout is to be adjusted. + */ + private static void adjustLayout(GridPane pane) { + // Iterate through each entry in the guiElementPositions map + for (Map.Entry entry : guiElementPositions.entrySet()) { + Node node = entry.getKey(); // The GUI element (Node) + Integer newRow = entry.getValue(); // The new row index for the element + + // Check if the node is a part of the GridPane's children + if (pane.getChildren().contains(node)) { + // Update the node's row index in the GridPane + GridPane.setRowIndex(node, newRow); + } + } + } + + +} diff --git a/src/main/groovy/qupath/ext/basicstitching/stitching/StitchingImplementations.groovy b/src/main/groovy/qupath/ext/basicstitching/stitching/StitchingImplementations.groovy new file mode 100644 index 0000000..559ac74 --- /dev/null +++ b/src/main/groovy/qupath/ext/basicstitching/stitching/StitchingImplementations.groovy @@ -0,0 +1,650 @@ +package qupath.ext.basicstitching.stitching + +import org.slf4j.LoggerFactory +import qupath.ext.basicstitching.utilities.UtilityFunctions +import qupath.lib.common.GeneralTools +import qupath.lib.gui.QuPathGUI +import qupath.lib.gui.dialogs.Dialogs +import qupath.lib.images.servers.ImageServerProvider +import qupath.lib.images.servers.ImageServers +import qupath.lib.images.servers.SparseImageServer +import qupath.lib.images.writers.ome.OMEPyramidWriter +import qupath.lib.regions.ImageRegion + +import javax.imageio.ImageIO +import javax.imageio.plugins.tiff.BaselineTIFFTagSet +import javax.imageio.plugins.tiff.TIFFDirectory +import java.awt.image.BufferedImage +import java.nio.file.Files +import java.nio.file.Path +import java.nio.file.Paths + +import static qupath.lib.scripting.QP.getLogger; + +//TODO Is there a way to apply the downsample when accessing the image regions so the full res image region doesn't need to be stored in memory? +// Maybe downsample after acquiring the region as a second step? + +// Interface for stitching strategies +interface StitchingStrategy { + List prepareStitching(String folderPath, double pixelSizeInMicrons, double baseDownsample, String matchingString) +} + +//TODO Look into reducing repetitive code here, though maybe the overall structure is wrong? +//abstract class BaseStitchingStrategy implements StitchingStrategy { +// protected List prepareStitchingCommon(String folderPath, double pixelSizeInMicrons, double baseDownsample, String matchingString, Closure processSubDirectory) { +// def logger = LoggerFactory.getLogger(QuPathGUI.class) +// Path rootdir = Paths.get(folderPath) +// List allFileRegionMaps = [] +// +// Files.newDirectoryStream(rootdir).each { path -> +// if (Files.isDirectory(path) && path.fileName.toString().contains(matchingString)) { +// def fileRegionMaps = processSubDirectory.call(path) +// allFileRegionMaps += fileRegionMaps +// } +// } +// +// if (allFileRegionMaps.isEmpty()) { +// Dialogs.showWarningNotification("Warning", "No valid tile configurations found in any subdirectory.") +// return [] +// } +// +// allFileRegionMaps +// } +//} +// Concrete strategy for stitching based on file names + +/** + * Strategy for stitching images based on file names. + * This class implements the {@link StitchingStrategy} interface and provides a specific + * algorithm for stitching based on the naming convention of image files. + */ +class FileNameStitchingStrategy implements StitchingStrategy { + + /** + * Prepares stitching by processing each subdirectory within the specified root directory. + * This method iterates over each subdirectory that matches the given criteria and + * aggregates file-region mapping information for stitching. + * + * @param folderPath The path to the root directory containing image files. + * @param pixelSizeInMicrons The pixel size in microns, used for calculating image regions. + * @param baseDownsample The base downsample value for the stitching process. + * @param matchingString A string to match for selecting relevant subdirectories. + * @return A list of maps, each map containing file, region, and subdirName information for stitching. + */ + @Override + List prepareStitching(String folderPath, double pixelSizeInMicrons, double baseDownsample, String matchingString) { + Path rootdir = Paths.get(folderPath) + List allFileRegionMaps = [] + + // Iterate over each subdirectory in the root directory + Files.newDirectoryStream(rootdir).each { path -> + if (Files.isDirectory(path) && path.fileName.toString().contains(matchingString)) { + // Process each subdirectory and collect file-region mappings + def fileRegionMaps = processSubDirectory(path, pixelSizeInMicrons, baseDownsample) + allFileRegionMaps += fileRegionMaps + } + } + + // Check if any valid file-region mappings were found + if (allFileRegionMaps.isEmpty()) { + Dialogs.showWarningNotification("Warning", "No valid tile configurations found in any subdirectory.") + return + } + + allFileRegionMaps + } + + /** + * Processes a single subdirectory to generate file-region mappings for stitching. + * This method collects all TIFF files in the directory, builds tile configurations, + * and creates a mapping of each file to its corresponding image region. + * + * @param dir The path to the subdirectory to be processed. + * @param pixelSizeInMicrons The pixel size in microns for calculating image regions. + * @param baseDownsample The base downsample value for the stitching process. + * @return A list of maps, each map containing file, region, and subdirName for stitching. + */ + private static List processSubDirectory(Path dir, double pixelSizeInMicrons, double baseDownsample) { + def logger = LoggerFactory.getLogger(QuPathGUI.class) + logger.info("Processing slide in folder $dir") + + // Collect all TIFF files in the directory + def files = [] + Files.newDirectoryStream(dir, "*.tif*").each { path -> + files << path.toFile() + } + + // Build tile configurations from the collected files + def tileConfigOutput = buildTileConfigWithMinCoordinates(dir) + def tileConfig = tileConfigOutput[0] + def minimumXY = tileConfigOutput[1] + + // Create file-region mappings for each file + List fileRegionMaps = [] + files.each { file -> + def region = parseRegionFromOffsetTileConfig(file as File, tileConfig as List, minimumXY, pixelSizeInMicrons) + if (region) { + // Add file, region, and subdir name to the mappings + fileRegionMaps << [file: file, region: region, subdirName: dir.getFileName().toString()] + } + } + + return fileRegionMaps + } + +/** + * Parses an image region from offset tile configuration. + * This method calculates the region of an image file based on its position within a larger stitched image. + * + * @param file The image file for which to parse the region. + * @param tileConfig A list of maps containing tile configurations, each with image name and its coordinates. + * @param minimumXY The minimum x and y coordinates among all tiles, used for offset calculations. + * @param pixelSizeInMicrons The size of a pixel in microns, used for scaling coordinates. + * @param z The z-plane index of the image (default is 0). + * @param t The timepoint index of the image (default is 0). + * @return An ImageRegion object representing the specified region of the image or null if not found. + */ + static ImageRegion parseRegionFromOffsetTileConfig(File file, List tileConfig, minimumXY, double pixelSizeInMicrons, int z = 0, int t = 0) { + String imageName = file.getName() + def config = tileConfig.find { it.imageName == imageName } + def logger = LoggerFactory.getLogger(QuPathGUI.class) + + if (config) { + int x = (config.x - minimumXY[0]) / pixelSizeInMicrons as int + int y = (config.y - minimumXY[1]) / pixelSizeInMicrons as int + def dimensions = UtilityFunctions.getTiffDimensions(file) + if (dimensions == null) { + logger.info("Could not retrieve dimensions for image $imageName") + return null + } + int width = dimensions.width + int height = dimensions.height + return ImageRegion.createInstance(x, y, width, height, z, t) + } else { + logger.info("No configuration found for image $imageName") + return null + } + } + +/** + * Builds tile configurations with minimum coordinates for a given directory. + * This method scans a directory for image files and extracts their coordinates from the file names. + * It then calculates the minimum X and Y coordinates among all images. + * + * @param dir The directory path containing the image files. + * @return A list containing two elements: a list of image configurations and an array [minX, minY]. + */ + static def buildTileConfigWithMinCoordinates(Path dir) { + def images = [] + def logger = LoggerFactory.getLogger(QuPathGUI.class) + Files.newDirectoryStream(dir, "*.{tif,tiff,ome.tif}").each { path -> + def matcher = path.fileName.toString() =~ /.*\[(\d+),(\d+)\].*\.(tif|tiff|ome.tif)$/ + if (matcher.matches()) { + def imageName = path.getFileName().toString() + int x = Integer.parseInt(matcher[0][1]) + int y = Integer.parseInt(matcher[0][2]) + images << ['imageName': imageName, 'x': x, 'y': y] + } + } + + def minX = images.min { it.x }?.x ?: 0 + def minY = images.min { it.y }?.y ?: 0 + return [images, [minX, minY]] + } +} + + +/** + * Strategy for stitching images based on tile configurations specified in a TileConfiguration.txt file. + * This class implements the {@link StitchingStrategy} interface, providing an algorithm + * for processing and stitching images based on their defined tile configurations. + */ +class TileConfigurationTxtStrategy implements StitchingStrategy { + + /** + * Prepares stitching by processing each subdirectory within the specified root directory. + * This method iterates over each subdirectory that matches the given criteria and + * aggregates file-region mapping information for stitching. + * + * @param folderPath The path to the root directory containing image files. + * @param pixelSizeInMicrons The pixel size in microns, used for calculating image regions. + * @param baseDownsample The base downsample value for the stitching process. + * @param matchingString A string to match for selecting relevant subdirectories. + * @return A list of maps, each map containing file, region, and subdirName information for stitching. + */ + @Override + List prepareStitching(String folderPath, double pixelSizeInMicrons, double baseDownsample, String matchingString) { + Path rootdir = Paths.get(folderPath) + List allFileRegionMaps = [] + + // Iterate over each subdirectory in the root directory + Files.newDirectoryStream(rootdir).each { path -> + if (Files.isDirectory(path) && path.fileName.toString().contains(matchingString)) { + // Process each subdirectory and collect file-region mappings + def fileRegionMaps = processSubDirectory(path, pixelSizeInMicrons, baseDownsample) + allFileRegionMaps += fileRegionMaps + } + } + + // Check if any valid file-region mappings were found + if (allFileRegionMaps.isEmpty()) { + Dialogs.showWarningNotification("Warning", "No valid tile configurations found in any subdirectory.") + return [] + } + + allFileRegionMaps + } + + /** + * Processes a single subdirectory to generate file-region mappings for stitching. + * This method reads the TileConfiguration.txt file in the directory (if present), + * collects all TIFF files, and creates a mapping of each file to its corresponding image region. + * + * @param dir The path to the subdirectory to be processed. + * @param pixelSizeInMicrons The pixel size in microns for calculating image regions. + * @param baseDownsample The base downsample value for the stitching process. + * @return A list of maps, each map containing file, region, and subdirName for stitching. + */ + private static List processSubDirectory(Path dir, double pixelSizeInMicrons, double baseDownsample) { + def logger = LoggerFactory.getLogger(QuPathGUI.class) + logger.info("Processing slide in folder $dir") + + // Check for the existence of TileConfiguration.txt in the directory + Path tileConfigPath = dir.resolve("TileConfiguration.txt") + if (!Files.exists(tileConfigPath)) { + logger.info("Skipping folder as TileConfiguration.txt is missing: $dir") + return [] + } + def tileConfig = parseTileConfiguration(tileConfigPath.toString()) + + logger.info('completed parseTileConfiguration') + + // Collect all TIFF files in the directory + List files = [] + Files.newDirectoryStream(dir, "*.tif*").each { path -> + files << path.toFile() + } + // Extract file names from tileConfig + Set tileConfigFileNames = tileConfig.collect { it.imageName } + + // Extract file names from the directory + Set directoryFileNames = files.collect { it.name } + + // Check if tileConfig file names match with the actual file names in the directory + if (!tileConfigFileNames.equals(directoryFileNames)) { + logger.warn("Mismatch between tile configuration file names and actual file names in directory: $dir") + + return [] // Optionally skip processing if there is a mismatch + } + // Create file-region mappings for each file + List fileRegionMaps = [] + files.each { File file -> + logger.info("parsing region from file $file") + ImageRegion region = parseRegionFromTileConfig(file as File, tileConfig as List) + if (region) { + logger.info("Processing file: ${file.path}") + fileRegionMaps << [file: file, region: region, subdirName: dir.getFileName().toString()] + } + } + + return fileRegionMaps + } + /** + * Parses the 'TileConfiguration.txt' file to extract image names and their coordinates. + * The function reads each line of the file, ignoring comments and blank lines. + * It extracts the image name and coordinates, then stores them in a list. + * + * @param filePath The path to the 'TileConfiguration.txt' file. + * @return A list of maps, each containing the image name and its coordinates (x, y). + */ + static def parseTileConfiguration(String filePath) { + def lines = Files.readAllLines(Paths.get(filePath)) + def imageCoordinates = [] + + lines.each { line -> + if (!line.startsWith("#") && !line.trim().isEmpty()) { + def parts = line.split(";") + if (parts.length >= 3) { + def imageName = parts[0].trim() + def coordinates = parts[2].trim().replaceAll("[()]", "").split(",") + imageCoordinates << [imageName: imageName, x: Double.parseDouble(coordinates[0]), y: Double.parseDouble(coordinates[1])] + } + } + } + + return imageCoordinates + } + /** + * Parse an ImageRegion from the TileConfiguration.txt data and TIFF file dimensions. + * @param imageName Name of the image file for which to get the region. + * @param tileConfig List of tile configurations parsed from TileConfiguration.txt. + * @param z index of z plane. + * @param t index of timepoint. + * @return An ImageRegion object representing the specified region of the image. + */ + static ImageRegion parseRegionFromTileConfig(File file, List tileConfig, int z = 0, int t = 0) { + String imageName = file.getName() + def config = tileConfig.find { it.imageName == imageName } + + if (config) { + int x = config.x as int + int y = config.y as int + def dimensions = UtilityFunctions.getTiffDimensions(file) + if (dimensions == null) { + logger.info("Could not retrieve dimensions for image $imageName") + return null + } + int width = dimensions.width + int height = dimensions.height + //logger.info( x+" "+y+" "+ width+ " " + height) + return ImageRegion.createInstance(x, y, width, height, z, t) + } else { + logger.info("No configuration found for image $imageName") + return null + } + } +} + + +/** + * Strategy for stitching images based on Vectra metadata. + * This class implements the {@link StitchingStrategy} interface, providing an algorithm + * for processing and stitching images based on metadata from Vectra imaging systems. + */ +class VectraMetadataStrategy implements StitchingStrategy { + + /** + * Prepares stitching by processing each subdirectory within the specified root directory. + * This method iterates over each subdirectory that matches the given criteria and + * aggregates file-region mapping information for stitching. + * + * @param folderPath The path to the root directory containing image files. + * @param pixelSizeInMicrons The pixel size in microns, used for calculating image regions. + * @param baseDownsample The base downsample value for the stitching process. + * @param matchingString A string to match for selecting relevant subdirectories. + * @return A list of maps, each map containing file, region, and subdirName information for stitching. + */ + @Override + List prepareStitching(String folderPath, double pixelSizeInMicrons, double baseDownsample, String matchingString) { + Path rootdir = Paths.get(folderPath) + List allFileRegionMaps = [] + + // Iterate over each subdirectory in the root directory + Files.newDirectoryStream(rootdir).each { path -> + if (Files.isDirectory(path) && path.fileName.toString().contains(matchingString)) { + // Process each subdirectory and collect file-region mappings + def fileRegionMaps = processSubDirectory(path, pixelSizeInMicrons, baseDownsample) + allFileRegionMaps += fileRegionMaps + } + } + + // Check if any valid file-region mappings were found + if (allFileRegionMaps.isEmpty()) { + Dialogs.showWarningNotification("Warning", "No valid tile configurations found in any subdirectory.") + return [] + } + + allFileRegionMaps + } + + /** + * Processes a single subdirectory to generate file-region mappings for stitching. + * This method collects all TIFF files in the directory and creates a mapping of each file + * to its corresponding image region based on Vectra metadata. + * + * @param dir The path to the subdirectory to be processed. + * @param pixelSizeInMicrons The pixel size in microns for calculating image regions. + * @param baseDownsample The base downsample value for the stitching process. + * @return A list of maps, each map containing file, region, and subdirName for stitching. + */ + private static List processSubDirectory(Path dir, double pixelSizeInMicrons, double baseDownsample) { + def logger = LoggerFactory.getLogger(QuPathGUI.class) + logger.info("Processing slide in folder $dir") + + // Collect all TIFF files in the directory + List files = [] + Files.newDirectoryStream(dir, "*.tif*").each { path -> + files << path.toFile() + } + logger.info('Parsing regions from ' + files.size() + ' files...') + + // Create file-region mappings for each file + List fileRegionMaps = [] + files.each { File file -> + ImageRegion region = parseRegion(file as File) + if (region) { + fileRegionMaps << [file: file, region: region, subdirName: dir.getFileName().toString()] + } + } + + return fileRegionMaps + } + + /** + * Parses the image region from a given file based on Vectra metadata. + * This method checks if the file is a TIFF and then parses the region from the TIFF file. + * + * @param file The image file for which to parse the region. + * @param z The z-plane index of the image (default is 0). + * @param t The timepoint index of the image (default is 0). + * @return An ImageRegion object representing the specified region of the image, or null if not found. + */ + static ImageRegion parseRegion(File file, int z = 0, int t = 0) { + if (checkTIFF(file)) { + try { + return parseRegionFromTIFF(file, z, t) + } catch (Exception e) { + print e.getLocalizedMessage() + } + } + } + + /** + * Checks if the provided file is a TIFF image by examining its 'magic number'. + * TIFF files typically start with a specific byte order indicator (0x4949 for little-endian + * or 0x4d4d for big-endian), followed by a fixed number (42 or 43). + * + * @param file The file to be checked. + * @return True if the file is a TIFF image, false otherwise. + */ + static boolean checkTIFF(File file) { + file.withInputStream { + def bytes = it.readNBytes(4) + short byteOrder = toShort(bytes[0], bytes[1]) + + // Interpret the next two bytes based on the byte order + int val + if (byteOrder == 0x4949) { // Little-endian + val = toShort(bytes[3], bytes[2]) + } else if (byteOrder == 0x4d4d) { // Big-endian + val = toShort(bytes[2], bytes[3]) + } else + return false + + return val == 42 || val == 43 // TIFF magic number + } + } + + /** + * Converts two bytes into a short, in the specified byte order. + * + * @param b1 The first byte. + * @param b2 The second byte. + * @return The combined short value. + */ + static short toShort(byte b1, byte b2) { + return (b1 << 8) + (b2 << 0) + } + + /** + * Parses the image region from a TIFF file using metadata information. + * Reads TIFF metadata to determine the image's physical position and dimensions, + * then calculates and returns the corresponding ImageRegion object. + * + * @param file The TIFF image file to parse. + * @param z The z-plane index of the image (default is 0). + * @param t The timepoint index of the image (default is 0). + * @return An ImageRegion object representing the specified region of the image. + */ + static ImageRegion parseRegionFromTIFF(File file, int z = 0, int t = 0) { + int x, y, width, height + file.withInputStream { + def reader = ImageIO.getImageReadersByFormatName("TIFF").next() + reader.setInput(ImageIO.createImageInputStream(it)) + def metadata = reader.getImageMetadata(0) + def tiffDir = TIFFDirectory.createFromMetadata(metadata) + + // Extract resolution and position values from the metadata + double xRes = getRational(tiffDir, BaselineTIFFTagSet.TAG_X_RESOLUTION) + double yRes = getRational(tiffDir, BaselineTIFFTagSet.TAG_Y_RESOLUTION) + double xPos = getRational(tiffDir, BaselineTIFFTagSet.TAG_X_POSITION) + double yPos = getRational(tiffDir, BaselineTIFFTagSet.TAG_Y_POSITION) + + // Extract image dimensions from the metadata + width = tiffDir.getTIFFField(BaselineTIFFTagSet.TAG_IMAGE_WIDTH).getAsLong(0) as int + height = tiffDir.getTIFFField(BaselineTIFFTagSet.TAG_IMAGE_LENGTH).getAsLong(0) as int + + // Calculate the x and y coordinates in the final stitched image + x = Math.round(xRes * xPos) as int + y = Math.round(yRes * yPos) as int + } + return ImageRegion.createInstance(x, y, width, height, z, t) + } + + /** + * Extracts a rational number from TIFF metadata based on the specified tag. + * The rational number is represented as a fraction (numerator/denominator). + * + * @param tiffDir The TIFFDirectory object containing the metadata. + * @param tag The metadata tag to extract the rational number from. + * @return The rational number as a double. + */ + static double getRational(TIFFDirectory tiffDir, int tag) { + long[] rational = tiffDir.getTIFFField(tag).getAsRational(0) + return rational[0] / (double) rational[1] + } +} + + +/** + * Class responsible for managing stitching strategies and executing the stitching process. + * This class sets the appropriate stitching strategy based on the given type and coordinates the stitching process. + */ +class StitchingImplementations { + private static StitchingStrategy strategy + + /** + * Sets the stitching strategy to be used. + * + * @param strategy The stitching strategy to be set. + */ + static void setStitchingStrategy(StitchingStrategy strategy) { + StitchingImplementations.strategy = strategy + } + + /** + * Core method to perform stitching based on the specified stitching type and other parameters. + * This method determines the stitching strategy, prepares stitching, and then performs the stitching process. + * + * @param stitchingType The type of stitching to be performed. + * @param folderPath The path to the folder containing images to be stitched. + * @param compressionType The type of compression to be used in the stitching output. + * @param pixelSizeInMicrons The size of a pixel in microns. + * @param baseDownsample The base downsample value for the stitching process. + * @param matchingString A string to match for selecting relevant subdirectories or files. + */ + static String stitchCore(String stitchingType, String folderPath, String outputPath, + String compressionType, double pixelSizeInMicrons, + double baseDownsample, String matchingString) { + def logger = LoggerFactory.getLogger(QuPathGUI.class) + // Determine the stitching strategy based on the provided type + logger.info("Stitching type is: $stitchingType") + switch (stitchingType) { + + case "Filename[x,y] with coordinates in microns": + setStitchingStrategy(new FileNameStitchingStrategy()) + break + case "Vectra tiles with metadata": + setStitchingStrategy(new VectraMetadataStrategy()) + break + case "Coordinates in TileConfiguration.txt file": + setStitchingStrategy(new TileConfigurationTxtStrategy()) + break + default: + Dialogs.showWarningNotification("Warning", "Error with choosing a stitching method, code here should not be reached in StitchingImplementations.groovy") + return // Safely exit the method if the stitching type is not recognized + } + + // Proceed with the stitching process if a valid strategy is set + if (strategy) { + // Prepare stitching by processing the folder with the selected strategy + def fileRegionPairs = strategy.prepareStitching(folderPath, pixelSizeInMicrons, baseDownsample, matchingString) + OMEPyramidWriter.CompressionType compression = UtilityFunctions.getCompressionType(compressionType) + def builder = new SparseImageServer.Builder() + + // Check if valid file-region pairs were obtained + if (fileRegionPairs == null || fileRegionPairs.isEmpty()) { + Dialogs.showWarningNotification("Warning", "No valid folders found matching the criteria.") + return // Exit the method if no valid file-region pairs are found + } + + def subdirName + // Process each file-region pair to build the image server for stitching + fileRegionPairs.each { pair -> + if (pair == null) { + logger.warn("Encountered a null pair in fileRegionPairs") + return // Skip this iteration if the pair is null + } + def file = pair['file'] as File + def region = pair['region'] as ImageRegion + subdirName = pair['subdirName'] as String // Extract subdirName from the pair + + if (file == null) { + logger.warn("File is null in pair: $pair") + return // Skip this iteration if the file is null + } + + if (region == null) { + logger.warn("Region is null in pair: $pair") + return // Skip this iteration if the region is null + } + + // Add the region to the image server builder + def serverBuilder = ImageServerProvider.getPreferredUriImageSupport(BufferedImage.class, file.toURI().toString()).getBuilders().get(0) + builder.jsonRegion(region, 1.0, serverBuilder) + } + + // Build and pyramidalize the server for the final stitched image + def server = builder.build() + server = ImageServers.pyramidalize(server) + + // Write the final stitched image + long startTime = System.currentTimeMillis() + def filename = subdirName ?: Paths.get(folderPath).getFileName().toString() + def outputFilePath = baseDownsample == 1 ? + Paths.get(outputPath).resolve(filename + '.ome.tif') : + Paths.get(outputPath).resolve(filename + '_' + (int) baseDownsample + 'x_downsample.ome.tif') + + //def fileOutput = outputFilePath.toFile() + //String pathOutput = fileOutput.getAbsolutePath() + String pathOutput = outputFilePath.toAbsolutePath().toString() + pathOutput = UtilityFunctions.getUniqueFilePath(pathOutput) + new OMEPyramidWriter.Builder(server) + .tileSize(512) + .channelsInterleaved() + .parallelize(true) + .compression(compression) + .scaledDownsampling(baseDownsample, 4) + .build() + .writePyramid(pathOutput) + + long endTime = System.currentTimeMillis() + logger.info("Image written to ${pathOutput} in ${GeneralTools.formatNumber((endTime - startTime) / 1000.0, 1)} s") + server.close() + return pathOutput + } else { + println("No valid stitching strategy set.") + } + } +} + diff --git a/src/main/groovy/qupath/ext/basicstitching/utilities/UtilityFunctions.groovy b/src/main/groovy/qupath/ext/basicstitching/utilities/UtilityFunctions.groovy new file mode 100644 index 0000000..c8b7551 --- /dev/null +++ b/src/main/groovy/qupath/ext/basicstitching/utilities/UtilityFunctions.groovy @@ -0,0 +1,131 @@ +package qupath.ext.basicstitching.utilities + +import org.slf4j.LoggerFactory +import qupath.lib.gui.QuPathGUI +import qupath.lib.images.writers.ome.OMEPyramidWriter + +import javax.imageio.ImageIO +import java.lang.reflect.Modifier +import java.nio.file.Files +import java.nio.file.Path +import java.nio.file.Paths + +/** + * Class containing utility functions used throughout the application. + */ +class UtilityFunctions { + static ArrayList getCompressionTypeList() { + def compressionTypeClass = OMEPyramidWriter.CompressionType + +// Retrieve all declared fields in the class + def fields = compressionTypeClass.declaredFields + +// Filter only public static final fields + def compressionTypes = fields.findAll { + Modifier.isPublic(it.modifiers) && + Modifier.isStatic(it.modifiers) && + Modifier.isFinal(it.modifiers) + } + +// Extract the names of the fields + def compressionTypeNames = compressionTypes*.name + return compressionTypeNames + } + /** + * Gets the compression type for OMEPyramidWriter based on the selected option. + * + * @param selectedOption The selected compression option as a string. + * @return The corresponding OMEPyramidWriter.CompressionType. + * @throws IllegalArgumentException if the selected option does not match any compression type. + */ + static OMEPyramidWriter.CompressionType getCompressionType(String selectedOption) throws IllegalArgumentException { + try { + // Convert the string to an enum constant + return OMEPyramidWriter.CompressionType.valueOf(selectedOption); + } catch (IllegalArgumentException e) { + // Throw an exception if no matching compression type is found + throw new IllegalArgumentException("Invalid compression type: " + selectedOption); + } + } +/** + * Generates a unique file path by appending a number to the file name if a file with the + * same name already exists. The first instance of the file will have no number appended, + * while the second will have _2, the third _3, and so on. + * + * @param originalPath The original file path. + * @return A unique file path. + */ + static String getUniqueFilePath(String originalPath) { + Path path = Paths.get(originalPath); + String baseName = path.getFileName().toString().replaceAll('\\.ome\\.tif$', ""); + Path parentDir = path.getParent(); + + // Start with the original base name + Path newPath = parentDir.resolve(baseName + ".ome.tif"); + int counter = 2; + + // If the file exists, start appending numbers + while (Files.exists(newPath)) { + newPath = parentDir.resolve(baseName + "_" + counter + ".ome.tif"); + counter++; + } + + return newPath.toString(); + } + + /** + * Retrieves the dimensions (width and height) of a TIFF image file. + * + * @param filePath The file path of the TIFF image. + * @return A map containing the 'width' and 'height' of the image, or null if an error occurs. + */ + static Map getTiffDimensions(File filePath) { + def logger = LoggerFactory.getLogger(QuPathGUI.class) + + // Check if the file exists + if (!filePath.exists()) { + logger.info("File not found: $filePath") + return null + } + + try { + // Read the image file + def image = ImageIO.read(filePath) + if (image == null) { + logger.info("ImageIO returned null for file: $filePath") + return null + } + + // Return the image dimensions as a map + return [width: image.getWidth(), height: image.getHeight()] + } catch (IOException e) { + // Log and handle the error + logger.info("Error reading the image file $filePath: ${e.message}") + return null + } + } +} + +//TODO Move this somewhere +// List prepareStitching(String folderPath, double pixelSizeInMicrons, double baseDownsample, String matchingString) { +// def logger = LoggerFactory.getLogger(QuPathGUI.class) +// Path rootdir = Paths.get(folderPath) +// List allFileRegionMaps = [] // This will store the file-region maps for all subdirectories +// def subdir = [] +// +// Files.newDirectoryStream(rootdir).each { path -> +// if (Files.isDirectory(path) && path.fileName.toString().contains(matchingString)) { +// logger.info("Processing: $path") +// def fileRegionMaps = processSubDirectory(path, pixelSizeInMicrons, baseDownsample) +// allFileRegionMaps += fileRegionMaps +// } +// } +// +// if (allFileRegionMaps.isEmpty()) { +// Dialogs.showWarningNotification("Warning", "No valid tile configurations found in any subdirectory.") +// return +// } +// +// allFileRegionMaps +// } +//} diff --git a/src/main/resources/META-INF/services/qupath.lib.gui.extensions.QuPathExtension b/src/main/resources/META-INF/services/qupath.lib.gui.extensions.QuPathExtension new file mode 100644 index 0000000..6338450 --- /dev/null +++ b/src/main/resources/META-INF/services/qupath.lib.gui.extensions.QuPathExtension @@ -0,0 +1 @@ +qupath.ext.basicstitching.BasicStitchingExtension