@openglobus/og 0.17.2 → 0.18.1

package/src/og/math.js

@@ -1,430 +0,0 @@
-/**
- * @module og/math
- */
-
-"use strict";
-
-/** @const */
-export const TWO_PI = 2.0 * Math.PI;
-
-/** @const */
-export const PI_TWO = Math.PI / 2.0;
-
-export const X = 0;
-export const Y = 1;
-export const Z = 2;
-export const W = 3;
-
-export const MAX_FLOAT = Number.MAX_VALUE || 1.7976931348623157e308;
-
-/** @const */
-export const LOG2 = Math.log(2);
-/** @const */
-export const MAX32 = 2147483647;
-/** @const */
-export const MAX = 549755748352;
-/** @const */
-export const MIN = -MAX;
-
-/** @const */
-export const RADIANS = Math.PI / 180.0;
-/** @const */
-export const DEGREES = 180.0 / Math.PI;
-
-/** @const */
-export const DEGREES_DOUBLE = 2.0 * DEGREES;
-/** @const */
-export const RADIANS_HALF = 0.5 * RADIANS;
-
-/** @const */
-export const ARCSECONDS_TO_RADIANS = 0.00000484813681109536;
-/** @const */
-export const RADIANS_TO_HOURS = 3.8197186342054880584532103209403;
-/** @const */
-export const HOURS_TO_RADIANS = 0.26179938779914943653855361527329;
-/** @const */
-export const HOURS_TO_DEGREES = 15.0;
-/** @const */
-export const DEGREES_TO_HOURS = 1.0 / 15.0;
-
-/** @const */
-export const SQRT_HALF = Math.sqrt(0.5);
-
-export const EPS1 = 1e-1;
-export const EPS2 = 1e-2;
-export const EPS3 = 1e-3;
-export const EPS4 = 1e-4;
-export const EPS5 = 1e-5;
-export const EPS6 = 1e-6;
-export const EPS7 = 1e-7;
-export const EPS8 = 1e-8;
-export const EPS9 = 1e-9;
-export const EPS10 = 1e-10;
-export const EPS11 = 1e-11;
-export const EPS12 = 1e-12;
-export const EPS13 = 1e-13;
-export const EPS14 = 1e-14;
-export const EPS15 = 1e-15;
-export const EPS16 = 1e-16;
-export const EPS17 = 1e-17;
-export const EPS18 = 1e-18;
-export const EPS19 = 1e-19;
-export const EPS20 = 1e-20;
-
-/**
- * The log function returns the power to which the base value has to be raised to produce n.
- * @function
- * @param {number} n - Produce value.
- * @param {number} base - Base value.
- * @returns {number} -
- * @example
- * log(64, 2)
- * //returns 6
- */
-export function log(n, base) {
-    return Math.log(n) / Math.log(base);
-}
-
-/**
- * Clamp the number.
- * @function
- * @param {number} number - Input number.
- * @param {number} min - Minimal edge.
- * @param {number} max - Maximal edge.
- * @returns {number} -
- * @example
- * clamp(12, 1, 5)
- * //returns 5
- */
-export function clamp(number, min, max) {
-    return Math.max(min, Math.min(number, max));
-}
-
-/**
- * Converts degrees value to radians.
- * @function
- * @param {number} degrees - Degree value.
- * @returns {number} -
- */
-export function DEG2RAD(degrees) {
-    return degrees * RADIANS;
-}
-
-/**
- * Converts radians value to degrees.
- * @function
- * @param {number} angle - Degree value.
- * @returns {number} -
- */
-export function RAD2DEG(angle) {
-    return angle * DEGREES;
-}
-
-/**
- * Check the number is a power of two.
- * @function
- * @param {number} x - Input value.
- * @returns {boolean} -
- */
-export function isPowerOfTwo(x) {
-    return (x & (x - 1)) === 0;
-}
-
-/**
- * Returns next value that is power of two.
- * @function
- * @param {number} x - Input value.
- * @returns {number} -
- */
-export function nextHighestPowerOfTwo(x, maxValue = 4096) {
-    --x;
-    for (let i = 1; i < 32; i <<= 1) {
-        x = x | (x >> i);
-    }
-    return (x + 1) > maxValue ? maxValue : x + 1
-}
-
-/**
- * Returns random integer number within the bounds.
- * @function
- * @param {number} min - Minimal bound.
- * @param {number} max - Maximal bound.
- * @returns {number} -
- */
-export function randomi(min = 0, max = 1) {
-    return Math.floor(Math.random() * (max - min)) + min;
-}
-
-/**
- * Returns random number within the bounds.
- * @function
- * @param {number} [min=0] - Minimal bound.
- * @param {number} [max=1] - Maximal bound.
- * @returns {number} -
- */
-export function random(min = 0, max = 1) {
-    return Math.random() * (max - min) + min;
-}
-
-/**
- * Converts degrees value to decimal.
- * @function
- * @param {number} d - Degrees.
- * @param {number} m - Minutes.
- * @param {number} s - Seconds.
- * @param {boolean} [p] - Positive flag. False - default.
- * @returns {number} -
- **/
-export function degToDec(d, m, s, p) {
-    if (p) {
-        return d + m / 60.0 + s / 3600.0;
-    } else {
-        return -d - m / 60.0 - s / 3600.0;
-    }
-}
-
-/**
- * The modulo operation that also works for negative dividends.
- * @function
- * @param {number} m - The dividend.
- * @param {number} n - The divisor.
- * @returns {number} The remainder.
- */
-export function mod(m, n) {
-    return ((m % n) + n) % n;
-}
-
-/**
- * Returns an angle in the range 0 <= angle <= 2Pi which is equivalent to the provided angle.
- * @function
- * @param {number} a - Angle in radians
- * @returns {number} -
- */
-export function zeroTwoPI(a) {
-    const res = mod(a, TWO_PI);
-    if (Math.abs(res) < EPS14 && Math.abs(a) > EPS14) {
-        return TWO_PI;
-    }
-    return res;
-}
-
-/**
- * Returns 0.0 if x is smaller than edge and otherwise 1.0.
- * @function
- * @param {number} edge -
- * @param {number} x - Value to edge.
- * @returns {number} -
- */
-export function step(edge, x) {
-    return x < edge ? 0.0 : 1.0;
-}
-
-/**
- * The fract function returns the fractional part of x, i.e. x minus floor(x).
- * @function
- * @param {number} x - Input value.
- * @returns {number} -
- */
-export function frac(x) {
-    const mx = Math.abs(x)
-    return mx - Math.floor(mx);
-}
-
-/**
- * Returns Math.log(x) / Math.log(2)
- * @function
- * @param {number} x - Input value.
- * @returns {number} -
- */
-export function log2(x) {
-    return Math.log(x) / LOG2;
-}
-
-/**
- * Returns two power of n.
- * @function
- * @param {number} n - Power value.
- * @returns {number} -
- */
-export function exp2(n) {
-    return Math.pow(2, n);
-}
-
-/**
- * Returns two power of integer n.
- * @function
- * @param {number} n - Integer power value.
- * @returns {number} -
- */
-export function pow2i(n) {
-    return 2 << (n - 1);
-}
-
-/**
- * Returns a slice of linear interpolation t * (h1 - h0)
- * @param {number} t - A value that linearly interpolates between the h0 parameter and the h1 parameter.
- * @param {number} h1 - End value.
- * @param {number} h0 - Start value.
- * @returns {number} -
- */
-export function slice(t, h1, h0) {
-    return t * (h1 - h0);
-}
-
-/**
- * Performs a linear interpolation.
- * @function
- * @param {number} t - A value that linearly interpolates between the h0 parameter and the h1 parameter.
- * @param {number} h1 - End value.
- * @param {number} h0 - Start value.
- * @returns {number} -
- */
-export function lerp(t, h1, h0) {
-    return h0 + t * (h1 - h0);
-}
-
-export function cube(f) {
-    return f * f * f;
-}
-
-export function square(f) {
-    return f * f;
-}
-
-export function bezier1v(t, p0, p1, p2, p3) {
-    return (
-        cube(1 - t) * p0 + 3 * square(1 - t) * t * p1 + 3 * (1 - t) * square(t) * p2 + cube(t) * p3
-    );
-}
-
-/**
- * Performs a 3D bezier interpolation.
- * @function
- * @param {number} t - Interpolation value.
- * @param {Vec3} p0 - First control point.
- * @param {Vec3} p1 - Second control point.
- * @param {Vec3} p2 - Third control point.
- * @param {Vec3} p3 - Fourth control point.
- * @returns {Vec3} -
- */
-export function bezier3v(t, p0, p1, p2, p3) {
-    var u = 1 - t;
-    var tt = t * t;
-    var uu = u * u;
-    var uuu = uu * u;
-    var ttt = tt * t;
-
-    return p0
-        .scaleTo(uuu)
-        .addA(p1.scaleTo(3 * uu * t))
-        .addA(p2.scaleTo(3 * u * tt))
-        .addA(p3.scaleTo(ttt));
-}
-
-/**
- * Clamp angle value within 360.
- * @function
- * @param {number} x - Input angle.
- * @returns {number} -
- */
-export function rev(x) {
-    return x - Math.floor(x / 360.0) * 360.0;
-}
-
-/**
- * Clamp longitude within: -180 to +180 degrees.
- * @function
- * @param {number} lon - Longitude.
- * @returns {number} -
- */
-export function norm_lon(lon) {
-    return lon > 180 ? ((lon + 180) % 360) - 180 : lon < -180 ? ((lon - 180) % 360) + 180 : lon;
-}
-
-/**
- * Returns an angle in the range -Pi <= angle <= Pi which is equivalent to the provided angle.
- * @function
- * @param {number} a - Angle in radians.
- * @returns {number} -
- */
-export function negativePItoPI(a) {
-    return zeroTwoPI(a + Math.PI) - Math.PI;
-}
-
-/**
- * Solve using iteration method and a fixed number of steps.
- * @function
- * @param {equationCallback} f - Equation. Used in Euler's equation(see og.orbit) solving.
- * @param {number} x0 - First approximation.
- * @param {number} maxIter - Maximum iterations.
- * @returns {number} -
- */
-export function solve_iteration_fixed(f, x0, maxIter) {
-    var x = 0;
-    var x2 = x0;
-    for (let i = 0; i < maxIter; i++) {
-        x = x2;
-        x2 = f(x);
-    }
-    return x2;
-}
-
-/**
- * Solve using iteration; terminate when error is below err or the maximum
- * number of iterations is reached. Used in Euler's equation(see og.orbit) solving.
- * @function
- * @param {equationCallback} f - Equation.
- * @param {number} x0 - First approximation.
- * @param {number} err - Maximal accepted error value.
- * @param {number} maxIter - Maximum iterations.
- * @returns {number} -
- */
-export function solve_iteration(f, x0, err, maxIter = 50) {
-    var x = 0;
-    var x2 = x0;
-    for (let i = 0; i < maxIter; i++) {
-        x = x2;
-        x2 = f(x);
-        if (Math.abs(x2 - x) < err) {
-            return x2;
-        }
-    }
-    return x2;
-}
-
-/**
- * Equation function.
- * @callback equationCallback
- * @param {number} x - Equation variable.
- */
-
-/**
- *
- * @param a - First bearing angle
- * @param b - Second bearing angle
- * @returns {number}
- */
-function getAngleDirection(a, b) {
-    let a_y = Math.cos(a),
-        a_x = Math.sin(a),
-        b_y = Math.cos(b),
-        b_x = Math.sin(b);
-    let c = a_y * b_x - b_y * a_x,
-        d = a_x * b_x + a_y * b_y;
-    if (c > 0.0) {
-        return Math.acos(d);
-    }
-    return -Math.acos(d);
-}
-
-/**
- * Returns angle between two azimuths
- * @param {number} a - First azimuth angle
- * @param {number} b - Second azimuth angle
- * @returns {number}
- */
-export function getAngleBetweenAzimuths(a, b) {
-    a = zeroTwoPI(a);
-    b = zeroTwoPI(b);
-    return ((((a - b) % 360) + 360 + 180) % 360) - 180;
-}

package/src/og/mercator.js

@@ -1,149 +0,0 @@
-/**
- * @module og/mercator
- */
-
-'use strict';
-
-import { Extent } from "./Extent.js";
-import { LonLat } from './LonLat.js';
-
-/**
- * Mercator size.
- * @const
- * @type {number}
- */
-export const POLE = 20037508.34;
-
-export const POLE2 = POLE * 2.0;
-
-export const PI_BY_POLE = Math.PI / POLE;
-
-export const POLE_BY_PI = POLE / Math.PI;
-
-const HALF_PI = Math.PI * 0.5;
-
-export const POLE_BY_180 = POLE / 180.0;
-
-export const INV_POLE_BY_180 = 180.0 / POLE;
-
-const PI_BY_360 = Math.PI / 360.0;
-
-const PI_BY_180 = Math.PI / 180.0;
-
-const INV_PI_BY_180 = 180.0 / Math.PI;
-
-/**
- * Double mercator size.
- * @const
- * @type {number}
- */
-export const POLE_DOUBLE = 2.0 * POLE;
-
-/**
- * One by mercator double size.
- * @const
- * @type {number}
- */
-export const ONE_BY_POLE_DOUBLE = 1.0 / POLE_DOUBLE;
-
-export function forward(lonLat) {
-    return new LonLat(lonLat.lon * POLE / 180.0, Math.log(Math.tan((90.0 + lonLat.lat) * PI_BY_360)) * POLE_BY_PI, lonLat.height);
-}
-
-/**
- * Converts degrees longitude to mercator coordinate.
- * @function
- * @param {number} lon - Degrees geodetic longitude.
- * @returns {number} -
- */
-export function forward_lon(lon) {
-    return lon * POLE / 180.0;
-}
-
-/**
- * Converts degrees latitude to mercator coordinate.
- * @function
- * @param {number} lat - Degrees geodetic latitude.
- * @returns {number} -
- */
-export function forward_lat(lat) {
-    return Math.log(Math.tan((90.0 + lat) * PI_BY_360)) * POLE_BY_PI;
-}
-
-/**
- * Converts mercator longitude to degrees coordinate.
- * @function
- * @param {number} lon - Mercator longitude.
- * @returns {number} -
- */
-export function inverse_lon(lon) {
-    return 180 * lon / POLE;
-}
-
-/**
- * Converts mercator latitude to degrees coordinate.
- * @function
- * @param {number} lon - Mercator latitude.
- * @returns {number} -
- */
-export function inverse_lat(lat) {
-    return INV_PI_BY_180 * (2.0 * Math.atan(Math.exp(lat * PI_BY_POLE)) - HALF_PI);
-}
-
-/**
- * Returns mercator map tile grid horizontal coordinate index by geodetic 
- * longitude and zoom level. Where top left corner of the grid is 0 coordinate index.
- * @function
- * @param {number} lon - Geodetic degrees longitude.
- * @param {number} zoom - Zoom level.
- * @returns {number}
- */
-export function getTileX(lon, zoom) {
-    return Math.floor((lon + 180) / 360.0 * Math.pow(2, zoom));
-}
-
-/**
- * Returns mercator map tile grid vertical coordinate index by geodetic 
- * latitude and zoom level. Where top left corner of the grid is 0 coordinate index.
- * @function
- * @param {number} lat - Geodetic degrees latitude.
- * @param {number} zoom - Zoom level.
- * @returns {number}
- */
-export function getTileY(lat, zoom) {
-    return Math.floor((1.0 - Math.log(Math.tan(lat * PI_BY_180) + 1.0 / Math.cos(lat * PI_BY_180)) / Math.PI) * 0.5 * Math.pow(2, zoom));
-}
-
-/**
- * Converts geodetic coordinate array to mercator coordinate array.
- * @function
- * @param {Array.<LonLat>} lonLatArr - LonLat array to convert.
- * @returns {Array.<LonLat>}
- */
-export function forwardArray(lonlatArr) {
-    var res = [];
-    for (let i = 0; i < lonlatArr.length; i++) {
-        res.push(lonlatArr[i].forwardMercator());
-    }
-    return res;
-}
-
-export function getTileExtent(x, y, z) {
-    let size = POLE2 / Math.pow(2, z),
-        sw = new LonLat(-POLE + x * size, POLE - y * size - size);
-    return new Extent(sw, new LonLat(sw.lon + size, sw.lat + size));
-}
-
-/**
- * Max mercator latitude.
- * @const
- * @type {number}
- */
-export const MAX_LAT = inverse_lat(POLE);
-
-/**
- * Min mercator latitude.
- * @const
- * @type {number}
- */
-export const MIN_LAT = -MAX_LAT;

package/src/og/proj/EPSG3857.js

@@ -1,13 +0,0 @@
-/**
- * @module og/proj/EPSG3857
- */
-
-"use strict";
-
-import { Proj, Units } from "./Proj.js";
-
-/**
- * EPSG:3857 projection object.
- * @type {Proj}
- */
-export const EPSG3857 = new Proj({ code: "epsg:3857", units: Units.METERS });

package/src/og/proj/EPSG4326.js

@@ -1,13 +0,0 @@
-/**
- * @module og/proj/EPSG4326
- */
-
-"use strict";
-
-import { Proj, Units } from "./Proj.js";
-
-/**
- * EPSG:4326 projection object.
- * @type {Proj}
- */
-export const EPSG4326 = new Proj({ code: "epsg:4326", units: Units.DEGREES });

package/src/og/proj/Proj.js

@@ -1,59 +0,0 @@
-"use strict";
-
-/**
- * Projection units: 'degrees', 'ft', 'm' or 'km'.
- * @enum {string}
- * @api
- */
-export const Units = {
-    DEGREES: "degrees",
-    FEET: "ft",
-    METERS: "m",
-    KILOMETERS: "km"
-};
-
-/**
- * Meters per unit lookup table.
- * @const
- * @type {Object.<og.proj.Units, number>}
- */
-export const METERS_PER_UNIT = {};
-METERS_PER_UNIT[Units.FEET] = 0.3048;
-METERS_PER_UNIT[Units.METERS] = 1;
-METERS_PER_UNIT[Units.KILOMETERS] = 1000;
-
-let _counter = 0;
-class Proj {
-    constructor(options) {
-        /**
-         * @public
-         * @type {string}
-         */
-        this.code = options.code;
-
-        /**
-         * @public
-         * @type {proj.Units}
-         */
-        this.units = /** @type {Units} */ (options.units);
-
-        /**
-         * Projection identifier, especially usefull for comparison.
-         * @const
-         * @type {integer}
-         */
-        this.id = _counter++;
-    }
-
-    /**
-     * Compare projections.
-     * @public
-     * @param {Proj} proj - Projetion object.
-     * @returns {boolean}
-     */
-    equal(proj) {
-        return proj.id === this.id;
-    }
-}
-
-export { Proj };

package/src/og/quadTree/EPSG4326QuadTreeStrategy.js

@@ -1,27 +0,0 @@
-"use strict";
-
-import { Extent } from "../Extent.js";
-import { EPSG4326 } from "../proj/EPSG4326.js";
-import { Node } from "../quadTree/Node.js";
-import * as quadTree from "../quadTree/quadTree.js";
-import { SegmentLonLatWgs84 } from "../segment/SegmentLonLatWgs84.js";
-import { QuadTreeStrategy } from "./QuadTreeStrategy.js";
-
-export class EPSG4326QuadTreeStrategy extends QuadTreeStrategy {
-    constructor(options = {}) {
-        super(options);
-        this.name = "EPSG4326";
-        this.projection = EPSG4326;
-    }
-
-    init() {
-        let earthQuadTreeSouth = new Node(SegmentLonLatWgs84, this.planet, quadTree.NW, null, 0, 0,
-            Extent.createFromArray([-180, -90, 0, 90])
-        );
-        let earthQuadTreeWest = new Node(SegmentLonLatWgs84, this.planet, quadTree.NW, null, 0, 0,
-            Extent.createFromArray([0, -90, 180, 90])
-        );
-        this._quadTreeList.push(earthQuadTreeSouth);
-        this._quadTreeList.push(earthQuadTreeWest);
-    }
-}