Example Detect Describe Interface - Revision history

Peter at 20:58, 17 January 2022

2022-01-17T20:58:58Z

← Older revision		Revision as of 20:58, 17 January 2022
Line 2:		Line 2:

	Example Code:		Example Code:
	* [https://github.com/lessthanoptimal/BoofCV/blob/v0.38/examples/src/main/java/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]		* [https://github.com/lessthanoptimal/BoofCV/blob/v0.40/examples/src/main/java/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]

	Concepts:		Concepts:
Line 73:		Line 73:

	// load and match images		// load and match images
	~~ExampleAssociatePoints~~ app = new ExampleAssociatePoints(detDesc, associate, imageType);		var app = new ExampleAssociatePoints(detDesc, associate, imageType);

	BufferedImage imageA = UtilImageIO.~~loadImage~~(UtilIO.pathExample("stitch/kayak_01.jpg"));		BufferedImage imageA = UtilImageIO.loadImageNotNull(UtilIO.pathExample("stitch/kayak_01.jpg"));
	BufferedImage imageB = UtilImageIO.~~loadImage~~(UtilIO.pathExample("stitch/kayak_03.jpg"));		BufferedImage imageB = UtilImageIO.loadImageNotNull(UtilIO.pathExample("stitch/kayak_03.jpg"));

	app.associate(imageA, imageB);		app.associate(imageA, imageB);

Peter at 17:45, 12 July 2021

2021-07-12T17:45:07Z

← Older revision		Revision as of 17:45, 12 July 2021
Line 2:		Line 2:

	Example Code:		Example Code:
	* [https://github.com/lessthanoptimal/BoofCV/blob/v0.37/examples/src/main/java/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]		* [https://github.com/lessthanoptimal/BoofCV/blob/v0.38/examples/src/main/java/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]

	Concepts:		Concepts:
Line 17:		Line 17:
	* {@link DetectDescribePoint} provides a single unified interface for detecting interest points inside of images		* {@link DetectDescribePoint} provides a single unified interface for detecting interest points inside of images
	* and describing the features. For some features (e.g. SIFT) it can be much faster than the alternative approach		* and describing the features. For some features (e.g. SIFT) it can be much faster than the alternative approach
	* where individual algorithms are used for feature detection, orientation estimation, and describe. It also		* where individual algorithms are used for feature detection, orientation estimation, and describe. It also
	* simplifies the code.		* simplifies the code.
	*		*
Line 28:		Line 28:

	/**		/**
	* For some features, there are pre-made implementations of DetectDescribePoint. This has only been done		* For some features, there are pre-made implementations of DetectDescribePoint. This has only been done
	* in situations where there was a performance advantage or that it was a very common combination.		* in situations where there was a performance advantage or that it was a very common combination.
	*/		*/
	public static <T extends ImageGray<T>, TD extends TupleDesc>		public static <T extends ImageGray<T>, TD extends TupleDesc<TD>>
	DetectDescribePoint<T, TD> createFromPremade( Class<T> imageType ) {		DetectDescribePoint<T, TD> createFromPremade( Class<T> imageType ) {
	return (DetectDescribePoint)FactoryDetectDescribe.surfStable(		var config = new ConfigFastHessian();
	~~new ConfigFastHessian(1, 2, 200, 1, 9, 4, 4)~~, null,null, imageType);		config.maxFeaturesPerScale = 200;
	// return (DetectDescribePoint)FactoryDetectDescribe.sift(~~new ConfigCompleteSift(-1~~,~~5,300)~~);		return (DetectDescribePoint)FactoryDetectDescribe.surfStable(config, null, null, imageType);
			// var config = new ConfigCompleteSift();
			// config.detector.maxFeaturesPerScale = 400;
			// return (DetectDescribePoint)FactoryDetectDescribe.sift(config, imageType);
	}		}

	/**		/**
	* Any arbitrary implementation of InterestPointDetector, OrientationImage, DescribeRegionPoint		* Any arbitrary implementation of InterestPointDetector, OrientationImage, DescribeRegionPoint
	* can be combined into DetectDescribePoint. The syntax is more complex, but the end result is more flexible.		* can be combined into DetectDescribePoint. The syntax is more complex, but the end result is more flexible.
	* This should only be done if there isn't a pre-made DetectDescribePoint.		* This should only be done if there isn't a pre-made DetectDescribePoint.
	*/		*/
	public static <T extends ImageGray<T>, TD extends TupleDesc>		public static <T extends ImageGray<T>, TD extends TupleDesc<TD>>
	DetectDescribePoint<T, TD> createFromComponents( Class<T> imageType ) {		DetectDescribePoint<T, TD> createFromComponents( Class<T> imageType ) {
	// create a corner detector		// create a corner detector
	Class derivType = GImageDerivativeOps.getDerivativeType(imageType);		Class derivType = GImageDerivativeOps.getDerivativeType(imageType);
	GeneralFeatureDetector corner = FactoryDetectPoint.createShiTomasi(new ConfigGeneralDetector(1000,5,1), null, derivType);		GeneralFeatureDetector corner = FactoryDetectPoint.createShiTomasi(new ConfigGeneralDetector(1000, 5, 1), null, derivType);
	InterestPointDetector detector = FactoryInterestPoint.wrapPoint(corner, 1, imageType, derivType);		InterestPointDetector detector = FactoryInterestPoint.wrapPoint(corner, 1, imageType, derivType);

	// describe points using BRIEF		// describe points using BRIEF
	~~DescribeRegionPoint~~ describe = ~~FactoryDescribeRegionPoint~~.brief(new ConfigBrief(true), imageType);		DescribePointRadiusAngle describe = FactoryDescribePointRadiusAngle.brief(new ConfigBrief(true), imageType);

	// Combine together.		// Combine together.
Line 67:		Line 70:
	// Might as well have this example do something useful, like associate two images		// Might as well have this example do something useful, like associate two images
	ScoreAssociation scorer = FactoryAssociation.defaultScore(detDesc.getDescriptionType());		ScoreAssociation scorer = FactoryAssociation.defaultScore(detDesc.getDescriptionType());
	AssociateDescription associate = FactoryAssociation.greedy(new ConfigAssociateGreedy(true),scorer);		AssociateDescription associate = FactoryAssociation.greedy(new ConfigAssociateGreedy(true), scorer);

	// load and match images		// load and match images
	ExampleAssociatePoints app = new ExampleAssociatePoints(detDesc,associate,imageType);		ExampleAssociatePoints app = new ExampleAssociatePoints(detDesc, associate, imageType);

	BufferedImage imageA = UtilImageIO.loadImage(UtilIO.pathExample("stitch/kayak_01.jpg"));		BufferedImage imageA = UtilImageIO.loadImage(UtilIO.pathExample("stitch/kayak_01.jpg"));
	BufferedImage imageB = UtilImageIO.loadImage(UtilIO.pathExample("stitch/kayak_03.jpg"));		BufferedImage imageB = UtilImageIO.loadImage(UtilIO.pathExample("stitch/kayak_03.jpg"));

	app.associate(imageA,imageB);		app.associate(imageA, imageB);
	}		}
	}		}
	</syntaxhighlight>		</syntaxhighlight>

Peter at 20:03, 21 December 2020

2020-12-21T20:03:01Z

← Older revision		Revision as of 20:03, 21 December 2020
Line 2:		Line 2:

	Example Code:		Example Code:
	* [https://github.com/lessthanoptimal/BoofCV/blob/v0.36/examples/src/main/java/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]		* [https://github.com/lessthanoptimal/BoofCV/blob/v0.37/examples/src/main/java/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]

	Concepts:		Concepts:
Line 58:		Line 58:
	}		}

	public static void main( String ~~args~~[] ) {		public static void main( String[] args ) {

	Class imageType = GrayF32.class;		Class imageType = GrayF32.class;

Peter at 05:04, 18 May 2020

2020-05-18T05:04:55Z

← Older revision		Revision as of 05:04, 18 May 2020
Line 2:		Line 2:

	Example Code:		Example Code:
	* [https://github.com/lessthanoptimal/BoofCV/blob/v0.36/examples/src/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]		* [https://github.com/lessthanoptimal/BoofCV/blob/v0.36/examples/src/main/java/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]

	Concepts:		Concepts:

Peter at 05:02, 18 May 2020

2020-05-18T05:02:54Z

← Older revision		Revision as of 05:02, 18 May 2020
Line 2:		Line 2:

	Example Code:		Example Code:
	* [https://github.com/lessthanoptimal/BoofCV/blob/v0.34/examples/src/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]		* [https://github.com/lessthanoptimal/BoofCV/blob/v0.36/examples/src/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]

	Concepts:		Concepts:
Line 67:		Line 67:
	// Might as well have this example do something useful, like associate two images		// Might as well have this example do something useful, like associate two images
	ScoreAssociation scorer = FactoryAssociation.defaultScore(detDesc.getDescriptionType());		ScoreAssociation scorer = FactoryAssociation.defaultScore(detDesc.getDescriptionType());
	AssociateDescription associate = FactoryAssociation.greedy(scorer~~, Double.MAX_VALUE, true~~);		AssociateDescription associate = FactoryAssociation.greedy(new ConfigAssociateGreedy(true),scorer);

	// load and match images		// load and match images

Peter at 18:15, 7 July 2019

2019-07-07T18:15:28Z

← Older revision		Revision as of 18:15, 7 July 2019
Line 2:		Line 2:

	Example Code:		Example Code:
	* [https://github.com/lessthanoptimal/BoofCV/blob/v0.27/examples/src/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]		* [https://github.com/lessthanoptimal/BoofCV/blob/v0.34/examples/src/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]

	Concepts:		Concepts:
Line 47:		Line 47:
	// create a corner detector		// create a corner detector
	Class derivType = GImageDerivativeOps.getDerivativeType(imageType);		Class derivType = GImageDerivativeOps.getDerivativeType(imageType);
	GeneralFeatureDetector corner = FactoryDetectPoint.createShiTomasi(new ConfigGeneralDetector(1000,5,1), ~~false~~, derivType);		GeneralFeatureDetector corner = FactoryDetectPoint.createShiTomasi(new ConfigGeneralDetector(1000,5,1), null, derivType);
	InterestPointDetector detector = FactoryInterestPoint.wrapPoint(corner, 1, imageType, derivType);		InterestPointDetector detector = FactoryInterestPoint.wrapPoint(corner, 1, imageType, derivType);

Peter at 15:36, 17 August 2017

2017-08-17T15:36:20Z

← Older revision		Revision as of 15:36, 17 August 2017
Line 2:		Line 2:

	Example Code:		Example Code:
	* [https://github.com/lessthanoptimal/BoofCV/blob/v0.23/examples/src/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]		* [https://github.com/lessthanoptimal/BoofCV/blob/v0.27/examples/src/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]

	Concepts:		Concepts:
	* Interest point detection		* Interest point detection
	* Local region descriptors		* Local region descriptors

	~~Relevant Applets:~~
	* [[Applet_Point_Detected\| Interest Point Detector]]
	* [[Applet_Description_Region\| Describe Points]]

	Related Examples		Related Examples
Line 35:		Line 31:
	* in situations where there was a performance advantage or that it was a very common combination.		* in situations where there was a performance advantage or that it was a very common combination.
	*/		*/
	public static <T extends ImageGray, TD extends TupleDesc>		public static <T extends ImageGray<T>, TD extends TupleDesc>
	DetectDescribePoint<T, TD> createFromPremade( Class<T> imageType ) {		DetectDescribePoint<T, TD> createFromPremade( Class<T> imageType ) {
	return (DetectDescribePoint)FactoryDetectDescribe.surfStable(		return (DetectDescribePoint)FactoryDetectDescribe.surfStable(
Line 47:		Line 43:
	* This should only be done if there isn't a pre-made DetectDescribePoint.		* This should only be done if there isn't a pre-made DetectDescribePoint.
	*/		*/
	public static <T extends ImageGray, TD extends TupleDesc>		public static <T extends ImageGray<T>, TD extends TupleDesc>
	DetectDescribePoint<T, TD> createFromComponents( Class<T> imageType ) {		DetectDescribePoint<T, TD> createFromComponents( Class<T> imageType ) {
	// create a corner detector		// create a corner detector

Peter at 05:19, 28 March 2016

2016-03-28T05:19:53Z

← Older revision		Revision as of 05:19, 28 March 2016
Line 2:		Line 2:

	Example Code:		Example Code:
	* [https://github.com/lessthanoptimal/BoofCV/blob/v0.21/examples/src/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]		* [https://github.com/lessthanoptimal/BoofCV/blob/v0.23/examples/src/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]

	Concepts:		Concepts:
Line 35:		Line 35:
	* in situations where there was a performance advantage or that it was a very common combination.		* in situations where there was a performance advantage or that it was a very common combination.
	*/		*/
	public static <T extends ~~ImageSingleBand~~, TD extends TupleDesc>		public static <T extends ImageGray, TD extends TupleDesc>
	DetectDescribePoint<T, TD> createFromPremade( Class<T> imageType ) {		DetectDescribePoint<T, TD> createFromPremade( Class<T> imageType ) {
	return (DetectDescribePoint)FactoryDetectDescribe.surfStable(		return (DetectDescribePoint)FactoryDetectDescribe.surfStable(
Line 47:		Line 47:
	* This should only be done if there isn't a pre-made DetectDescribePoint.		* This should only be done if there isn't a pre-made DetectDescribePoint.
	*/		*/
	public static <T extends ~~ImageSingleBand~~, TD extends TupleDesc>		public static <T extends ImageGray, TD extends TupleDesc>
	DetectDescribePoint<T, TD> createFromComponents( Class<T> imageType ) {		DetectDescribePoint<T, TD> createFromComponents( Class<T> imageType ) {
	// create a corner detector		// create a corner detector
Line 64:		Line 64:
	public static void main( String args[] ) {		public static void main( String args[] ) {

	Class imageType = ~~ImageFloat32~~.class;		Class imageType = GrayF32.class;

	DetectDescribePoint detDesc = createFromPremade(imageType);		DetectDescribePoint detDesc = createFromPremade(imageType);

Peter at 05:01, 24 January 2016

2016-01-24T05:01:36Z

← Older revision		Revision as of 05:01, 24 January 2016
Line 2:		Line 2:

	Example Code:		Example Code:
	* [https://github.com/lessthanoptimal/BoofCV/blob/v0.20/examples/src/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]		* [https://github.com/lessthanoptimal/BoofCV/blob/v0.21/examples/src/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]

	Concepts:		Concepts:
Line 39:		Line 39:
	return (DetectDescribePoint)FactoryDetectDescribe.surfStable(		return (DetectDescribePoint)FactoryDetectDescribe.surfStable(
	new ConfigFastHessian(1, 2, 200, 1, 9, 4, 4), null,null, imageType);		new ConfigFastHessian(1, 2, 200, 1, 9, 4, 4), null,null, imageType);
	~~// note that SIFT only supports ImageFloat32~~		// return (DetectDescribePoint)FactoryDetectDescribe.sift(new ConfigCompleteSift(-1,5,300));
	// ~~if( imageType == ImageFloat32.class )~~
	// return (DetectDescribePoint)FactoryDetectDescribe.sift(~~null,~~new ~~ConfigSiftDetector~~(~~2,0,200~~,5),~~null,null~~);
	~~// else~~
	~~// throw new RuntimeException("Unsupported image type"~~);
	}		}

Peter at 16:42, 9 November 2015

2015-11-09T16:42:24Z

← Older revision		Revision as of 16:42, 9 November 2015
Line 2:		Line 2:

	Example Code:		Example Code:
	* [https://github.com/lessthanoptimal/BoofCV/blob/v0.16/examples/src/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]		* [https://github.com/lessthanoptimal/BoofCV/blob/v0.20/examples/src/boofcv/examples/features/ExampleDetectDescribe.java ExampleDetectDescribe.java]

	Concepts:		Concepts:
Line 80:		Line 80:
	ExampleAssociatePoints app = new ExampleAssociatePoints(detDesc,associate,imageType);		ExampleAssociatePoints app = new ExampleAssociatePoints(detDesc,associate,imageType);

	BufferedImage imageA = UtilImageIO.loadImage("~~../data/evaluation/~~stitch/kayak_01.jpg");		BufferedImage imageA = UtilImageIO.loadImage(UtilIO.pathExample("stitch/kayak_01.jpg"));
	BufferedImage imageB = UtilImageIO.loadImage("~~../data/evaluation/~~stitch/kayak_03.jpg");		BufferedImage imageB = UtilImageIO.loadImage(UtilIO.pathExample("stitch/kayak_03.jpg"));

	app.associate(imageA,imageB);		app.associate(imageA,imageB);