Convert OpCollections to Therapi Discovery

First, the parameters were converted to custom taglets (manually, sob).

Then the following perl commands were used to convert OpField
annotations into implNotes:

perl -0777 -i -pe
"s/(\s*)\*\/(\s*)\@OpField\(\s*names\s*=\s*\"([^\"]*)\"\s*,\s*params\s*=\s*\"[^\"]*\"\s*,\s*priority\s*=\s*([^\)]*)\)/\1*
\@implNote op names='\3', priority='\4'\1*\/\2\@FlopField/igs" **/*.java

perl -0777 -i -pe
"s/(\s*)\*\/(\s*)\@OpField\(\s*names\s*=\s*\"([^\"]*)\"\s*,\s*params\s*=\s*\"[^\"]*\"[^\)]*\)/\1*
\@implNote op names='\3'\1*\/\2\@FlopField/igs" **/*.java

Then I realized I had left my @FlopField indicator string in, yielding
the usage of the sed command:

sed -i -e '/@FlopField/d' **/*.java

Now I continue:

perl -0777 -i -pe
"s/(\s*)\*\/(\s*)\@OpField\(\s*names\s*=\s*\"([^\"]*)\"[^\)]*\)/\1*
\@implNote op names='\3'\1*\//igs" **/*.java

Of course, there are some with @SuppressWarnings annotations *sigh*

perl -0777 -i -pe
"s/(\s*)\*\/(\s*)\@OpField\(\s*names\s*=\s*\"([^\"]*)\"[^\)]*\)/\1*
\@implNote op names='\3'\1*\//igs" **/*.java

Continuing on:

perl -0777 -i -pe "s/([\t
]*)\@OpField\(\s*names\s*=\s*\"([^\"]*)\"\s*,\s*priority\s*=\s*([^\)]*)\s*\)/\1\/**\n\1
* \@implNote op names='\2', priority='\3'\n\1 *\//igs" **/*.java

perl -0777 -i -pe "s/([\t
]*)\@OpField\(\s*names\s*=\s*\"([^\"]*)\"[^\)]*\)/\1\/**\n\1 *
\@implNote op names='\2'\n\1 *\//igs" **/*.java

Finally, we rename the priorities to their decimal value. See last
commmit for method

Author: gselzer

imagej/imagej-ops2/src/main/java/module-info.java

@@ -142,6 +142,7 @@
 	provides org.scijava.types.TypeExtractor with
 			net.imagej.ops2.types.ImgFactoryTypeExtractor,
 			net.imagej.ops2.types.ImgLabelingTypeExtractor,
+			net.imagej.ops2.types.NativeImgTypeExtractor,
 			net.imagej.ops2.types.LabelingMappingTypeExtractor,
 			net.imagej.ops2.types.OutOfBoundsConstantValueFactoryTypeExtractor,
 			net.imagej.ops2.types.OutOfBoundsFactoryTypeExtractor,

imagej/imagej-ops2/src/main/java/net/imagej/ops2/convert/ConvertTypes.java

@@ -64,73 +64,165 @@
 @Plugin(type = OpCollection.class)
 public final class ConvertTypes<C extends ComplexType<C>, T extends IntegerType<T>> {
 
-	@OpField(names = "convert.bit", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.bit'
+	 */
 	public final Computers.Arity1<C, BitType> complexToBit = (input, output) -> output.set(input.getRealDouble() != 0);
 
-	@OpField(names = "convert.bit", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.bit'
+	 */
 	public final Computers.Arity1<T, BitType> integerToBit = (input, output) -> output.set(input.getIntegerLong() != 0);
 
-	@OpField(names = "convert.uint2", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint2'
+	 */
 	public final Computers.Arity1<C, Unsigned2BitType> complexToUint2 = (input, output) -> output.set((long) input.getRealDouble());
 
-	@OpField(names = "convert.uint2", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint2'
+	 */
 	public final Computers.Arity1<T, Unsigned2BitType> integerToUint2 = (input, output) -> output.set(input.getIntegerLong());
 
-	@OpField(names = "convert.uint4", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint4'
+	 */
 	public final Computers.Arity1<C, Unsigned4BitType> complexToUint4 = (input, output) -> output.set((long) input.getRealDouble());
 
-	@OpField(names = "convert.uint4", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint4'
+	 */
 	public final Computers.Arity1<T, Unsigned4BitType> integerToUint4 = (input, output) -> output.set(input.getIntegerLong());
 
-	@OpField(names = "convert.byte", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.byte'
+	 */
 	public final Computers.Arity1<C, ByteType> complexToInt8 = (input, output) -> output.set((byte) input.getRealDouble());
 
-	@OpField(names = "convert.byte", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.byte'
+	 */
 	public final Computers.Arity1<T, ByteType> integerToInt8 = (input, output) -> output.set((byte) input.getIntegerLong());
 
-	@OpField(names = "convert.uint8", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint8'
+	 */
 	public final Computers.Arity1<C, UnsignedByteType> complexToUint8 = (input, output) -> output.set((int) input.getRealDouble());
 
-	@OpField(names = "convert.uint8", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint8'
+	 */
 	public final Computers.Arity1<T, UnsignedByteType> integerToUint8 = (input, output) -> output.set(input.getInteger());
 
-	@OpField(names = "convert.uint12", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint12'
+	 */
 	public final Computers.Arity1<C, Unsigned12BitType> complexToUint12 = (input, output) -> output.set((long) input.getRealDouble());
 
-	@OpField(names = "convert.uint12", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint12'
+	 */
 	public final Computers.Arity1<T, Unsigned12BitType> integerToUint12 = (input, output) -> output.set(input.getIntegerLong());
 
-	@OpField(names = "convert.int16", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.int16'
+	 */
 	public final Computers.Arity1<C, ShortType> complexToInt16 = (input, output) -> output.set((short) input.getRealDouble());
 
-	@OpField(names = "convert.int16", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.int16'
+	 */
 	public final Computers.Arity1<T, ShortType> integerToInt16 = (input, output) -> output.set((short) input.getIntegerLong());
 
-	@OpField(names = "convert.uint16", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint16'
+	 */
 	public final Computers.Arity1<C, UnsignedShortType> complexToUint16 = (input, output) -> output.set((int) input.getRealDouble());
 
-	@OpField(names = "convert.uint16", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint16'
+	 */
 	public final Computers.Arity1<T, UnsignedShortType> integerToUint16 = (input, output) -> output.set(input.getInteger());
 
-	@OpField(names = "convert.int32", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.int32'
+	 */
 	public final Computers.Arity1<C, IntType> complexToInt32 = (input, output) -> output.set((int) input.getRealDouble());
 
-	@OpField(names = "convert.int32", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.int32'
+	 */
 	public final Computers.Arity1<T, IntType> integerToInt32 = (input, output) -> output.set(input.getInteger());
 
-	@OpField(names = "convert.uint32", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint32'
+	 */
 	public final Computers.Arity1<C, UnsignedIntType> complexToUint32 = (input, output) -> output.set((long) input.getRealDouble());
 
-	@OpField(names = "convert.uint32", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint32'
+	 */
 	public final Computers.Arity1<T, UnsignedIntType> integerToUint32 = (input, output) -> output.set(input.getIntegerLong());
 
-	@OpField(names = "convert.int64", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.int64'
+	 */
 	public final Computers.Arity1<C, LongType> complexToInt64 = (input, output) -> output.set((long) input.getRealDouble());
 
-	@OpField(names = "convert.int64", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.int64'
+	 */
 	public final Computers.Arity1<T, LongType> integerToInt64 = (input, output) -> output.set(input.getIntegerLong());
 
-	@OpField(names = "convert.uint64", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint64'
+	 */
 	public final Computers.Arity1<C, UnsignedLongType> complexToUint64 = (input, output) -> {
 		final BigDecimal bd = BigDecimal.valueOf(input.getRealDouble());
 		final BigDecimal r = bd.remainder(BigDecimal.ONE);
@@ -141,7 +233,11 @@ public final class ConvertTypes<C extends ComplexType<C>, T extends IntegerType<
 		}
 	};
 
-	@OpField(names = "convert.uint128", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint128'
+	 */
 	public final Computers.Arity1<C, Unsigned128BitType> complexToUint128 = (input, output) -> {
 		final BigDecimal bd = BigDecimal.valueOf(input.getRealDouble());
 		final BigDecimal r = bd.remainder(BigDecimal.ONE);
@@ -152,20 +248,40 @@ public final class ConvertTypes<C extends ComplexType<C>, T extends IntegerType<
 		}
 	};
 
-	@OpField(names = "convert.uint128", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.uint128'
+	 */
 	public final Computers.Arity1<T, Unsigned128BitType> integerToUint128 = (input, output) -> output.set(input.getBigInteger());
 
-	@OpField(names = "convert.float32", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.float32'
+	 */
 	public final Computers.Arity1<C, FloatType> complexToFloat32 = (input, output) -> output.set(input.getRealFloat());
 
-	@OpField(names = "convert.cfloat32", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.cfloat32'
+	 */
 	public final Computers.Arity1<C, ComplexFloatType> complexToCfloat32 = (input, output) -> output.set(input.getRealFloat(),
 			input.getImaginaryFloat());
 
-	@OpField(names = "convert.float64", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.float64'
+	 */
 	public final Computers.Arity1<C, DoubleType> complexToFloat64 = (input, output) -> output.set(input.getRealDouble());
 
-	@OpField(names = "convert.cfloat64", params = "input, output")
+	/**
+	 * @input input
+	 * @output output
+	 * @implNote op names='convert.cfloat64'
+	 */
 	public final Computers.Arity1<C, ComplexDoubleType> complexToCfloat64 = (input, output) -> output.set(input.getRealDouble(),
 			input.getImaginaryDouble());
 }

imagej/imagej-ops2/src/main/java/net/imagej/ops2/convert/Converters.java

@@ -13,11 +13,23 @@
 @Plugin(type = OpCollection.class)
 public class Converters<I, O extends Type<O>> {
 
-	@OpField(names = "convert", params = "inputII, converter, outputType, outputII")
+	/**
+	 * @input inputRAI
+	 * @input converter
+	 * @input outputType
+	 * @output outputII
+	 * @implNote op names='convert'
+	 */
 	public final Functions.Arity3<RandomAccessible<I>, Converter<? super I, ? super O>, O, RandomAccessible<O>> generalConverterRA = (
 			inputRA, converter, type) -> net.imglib2.converter.Converters.convert(inputRA, converter, type);
 
-	@OpField(names = "convert", params = "inputII, converter, outputType, outputII")
+	/**
+	 * @input inputII
+	 * @input converter
+	 * @input outputType
+	 * @output outputII
+	 * @implNote op names='convert'
+	 */
 	public final Functions.Arity3<IterableInterval<I>, Converter<? super I, ? super O>, O, IterableInterval<O>> generalConverterII = (
 			inputII, converter, type) -> net.imglib2.converter.Converters.convert(inputII, converter, type);