001/*******************************************************************************
002 * This software is provided as a supplement to the authors' textbooks on digital
003 * image processing published by Springer-Verlag in various languages and editions.
004 * Permission to use and distribute this software is granted under the BSD 2-Clause
005 * "Simplified" License (see http://opensource.org/licenses/BSD-2-Clause).
006 * Copyright (c) 2006-2023 Wilhelm Burger, Mark J. Burge. All rights reserved.
007 * Visit https://imagingbook.com for additional details.
008 ******************************************************************************/
009package imagingbook.common.geometry.mappings;
010
011import imagingbook.common.geometry.basic.Pnt2d;
012
013/**
014 * Implementing classes provide the Jacobian matrix for the associated mapping.
015 * 
016 * @author WB
017 *
018 */
019public interface Jacobian {
020
021        /**
022         * <p>
023         * Returns the Jacobian matrix for this mapping, evaluated at the given 2D point. See Appendix Sec. D.1.1 of [1] for
024         * more details.
025         * </p>
026         * <p>
027         * [1] W. Burger, M.J. Burge, <em>Digital Image Processing &ndash; An Algorithmic Introduction</em>, 3rd ed,
028         * Springer (2022).
029         * </p>
030         *
031         * @param pnt the 2D position to calculate the Jacobian for
032         * @return the Jacobian matrix
033         */
034        public double[][] getJacobian(Pnt2d pnt);
035
036}