Class TransformBuilder

  • Direct Known Subclasses:
    Linear­Transform­Builder, Localization­Grid­Builder

    public abstract class TransformBuilder
    extends Object
    Creates a transform which will map approximately the given source positions to the given target positions. The transform may be a linear approximation the minimize the errors in a least square sense, or a more accurate transform using a localization grid.

    Builders are not thread-safe. Builders can be used only once; points can not be added or modified after create(Math­Transform­Factory) has been invoked.

    Since:
    0.8

    Defined in the sis-referencing module

    • Constructor Detail

      • TransformBuilder

        protected TransformBuilder()
        For subclass constructors.
    • Method Detail

      • create

        public abstract MathTransform create​(MathTransformFactory factory)
                                      throws FactoryException
        Creates a transform from the source points to the target points. Invoking this method puts the builder in an unmodifiable state. Invoking this method more than once returns the same transform (the transform is not recomputed).
        Parameters:
        factory - the factory to use for creating the transform, or null for the default factory.
        Returns:
        the transform from source to target points.
        Throws:
        Factory­Exception - if the transform can not be created, for example because the target points have not be specified.