feat: another permuteImageAndMetadataForImagePlus helper method

Author: bogovicj

src/main/java/org/janelia/saalfeldlab/n5/universe/metadata/axes/AxisUtils.java

@@ -12,6 +12,7 @@
 import java.util.stream.IntStream;
 import java.util.stream.Stream;
 
+import org.janelia.saalfeldlab.n5.universe.metadata.MetadataUtils;
 import org.janelia.saalfeldlab.n5.universe.metadata.N5Metadata;
 import org.janelia.saalfeldlab.n5.universe.metadata.N5SpatialDatasetMetadata;
 import org.janelia.saalfeldlab.n5.universe.metadata.SpatialMetadata;
@@ -312,6 +313,32 @@ public static <T, M extends N5Metadata, A extends AxisMetadata & N5Metadata> Pai
 		return new ValuePair<>(img, meta);
 	}
 
+	public static <T, M extends N5Metadata, A extends AxisMetadata & N5Metadata> Pair<RandomAccessibleInterval<T>, M> permuteImageAndMetadataForImagePlus(
+			final int[] p, final RandomAccessibleInterval<T> img, final M meta) {
+
+		// store the permutation for metadata
+		final int[] metadataPermutation = Arrays.stream(p).filter(x -> x >= 0).toArray();
+
+		// pad the image permutation
+		AxisUtils.fillPermutation(p);
+
+		RandomAccessibleInterval<T> imgTmp = img;
+		while (imgTmp.numDimensions() < 5)
+			imgTmp = Views.addDimension(imgTmp, 0, 0);
+
+		RandomAccessibleInterval<T> imgOut;
+		M datasetMeta;
+		if (AxisUtils.isIdentityPermutation(p)) {
+			imgOut = imgTmp;
+			datasetMeta = meta;
+		} else {
+			imgOut = AxisUtils.permute(imgTmp, AxisUtils.invertPermutation(p));
+			datasetMeta = (M)MetadataUtils.permuteSpatialMetadata(meta, metadataPermutation);
+		}
+
+		return new ValuePair<>(imgOut, datasetMeta);
+	}
+
 	public static <T> RandomAccessibleInterval<T> reverseDimensions(final RandomAccessibleInterval<T> img) {
 
 		final int nd = img.numDimensions();