Examples of org.apache.sis.geometry.GeneralEnvelope.subEnvelope()

org.apache.sis.geometry.GeneralEnvelope.subEnvelope()

Returns a view over this envelope that encompass only some dimensions. The returned object is "live": changes applied on the original envelope is reflected in the sub-envelope view, and conversely.

This method is useful for querying and updating only some dimensions. For example in order to expand only the horizontal component of a four dimensional (x,y,z,t) envelope, one can use:

{@preformat javaenvelope.subEnvelope(0, 2).add(myPosition2D);}If the sub-envelope needs to be independent from the original envelope, use the following idiom: {@preformat javaGeneralEnvelope copy = envelope.subEnvelope(0, 2).clone();}The sub-envelope is initialized with a {@code null} {@linkplain #getCoordinateReferenceSystem() CRS}. This method does not compute a sub-CRS because it may not be needed, or the sub-CRS may be already known by the caller. @param beginIndex The index of the first valid ordinate value of the corners. @param endIndex The index after the last valid ordinate value of the corners. @return The sub-envelope of dimension {@code endIndex - beginIndex}. @throws IndexOutOfBoundsException If an index is out of bounds.

        }), matrix);
        /*
         * Test dropping a dimension.
         */
        final GeneralEnvelope expanded = new GeneralEnvelope(3);
        expanded.subEnvelope(0, 2).setEnvelope(srcEnvelope);
        expanded.setRange(2, 1000, 2000);
        matrix = Matrices.createTransform(expanded, dstEnvelope);
        assertEquals("numRow", 3, matrix.getNumRow());
        assertEquals("numCol", 4, matrix.getNumCol());
        assertEquals(Matrices.create(3, 4, new double[] {

            0,    0,   0,   1
        }), matrix);
        /*
         * Test adding a dimension with ordinate values set to zero.
         */
        expanded.subEnvelope(0, 2).setEnvelope(dstEnvelope);
        matrix = Matrices.createTransform(srcEnvelope, expanded);
        assertEquals("numRow", 4, matrix.getNumRow());
        assertEquals("numCol", 3, matrix.getNumCol());
        assertEquals(Matrices.create(4, 3, new double[] {
            3.0,  0,    50,

        }), matrix);
        /*
         * Test dropping a dimension.
         */
        final GeneralEnvelope expanded = new GeneralEnvelope(3);
        expanded.subEnvelope(0, 2).setEnvelope(srcEnvelope);
        expanded.setRange(2, 1000, 2000);
        matrix = Matrices.createTransform(
                expanded,    new AxisDirection[] {NORTH, WEST, UP},
                dstEnvelope, new AxisDirection[] {EAST, NORTH});
        assertEquals("numRow", 3, matrix.getNumRow());

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.