9957112168

Committed 16 Jul 2024 12:46PM UTC coverage: 89.717% (-0.05%) from 89.764%

Build # 9957112168

Build Type

Pull #2272

github

Committed by

web-flow

Commit Message

Merge 0770b46ae into 982b908a4

Pull Request Pull Request #2272: Entwine a la volee

Run Details

2871 of 3769 branches covered (76.17%)

Branch coverage included in aggregate %.

471 of 571 new or added lines in 14 files covered. (82.49%)

26 existing lines in 6 files now uncovered.

25100 of 27408 relevant lines covered (91.58%)

906.4 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

95.36

/src/Core/Geographic/Crs.js

import proj4 from 'proj4';

proj4.defs('EPSG:4978', '+proj=geocent +datum=WGS84 +units=m +no_defs');

function isString(s) {
    return typeof s === 'string' || s instanceof String;
}

function mustBeString(crs) {
    if (!isString(crs)) {
        throw new Error(`Crs parameter value must be a string: '${crs}'`);
    }
}

function isTms(crs) {
    return isString(crs) && crs.startsWith('TMS');
}

function isEpsg(crs) {
    return isString(crs) && crs.startsWith('EPSG');
}

function formatToTms(crs) {
    mustBeString(crs);
    return isTms(crs) ? crs : `TMS:${crs.match(/\d+/)[0]}`;
}

function formatToEPSG(crs) {
    mustBeString(crs);
    return isEpsg(crs) ? crs : `EPSG:${crs.match(/\d+/)[0]}`;
}

const UNIT = {
    DEGREE: 1,
    METER: 2,
    FOOT: 3,
};

function is4326(crs) {
    return crs === 'EPSG:4326';
}

function isGeocentric(crs) {
    mustBeString(crs);
    const projection = proj4.defs(crs);
    return !projection ? false : projection.projName == 'geocent';
}

function _unitFromProj4Unit(projunit) {
    if (projunit === 'degrees') {
        return UNIT.DEGREE;
    } else if (projunit === 'm' || projunit === 'meter') {
        return UNIT.METER;
    } else if (projunit === 'foot') {
        return UNIT.FOOT;
    } else {
        return undefined;
    }
}

function toUnit(crs) {
    mustBeString(crs);
    if (crs.startsWith('NAD')) {
        return _unitFromProj4Unit(proj4.defs(crs).units);
    }
    switch (crs) {
        case 'EPSG:4326' : return UNIT.DEGREE;
        case 'EPSG:4978' : return UNIT.METER;
        default: {
            const p = proj4.defs(crs.startsWith('NAD') ? crs : formatToEPSG(crs));
            if (!p) {
                return undefined;
            }
            return _unitFromProj4Unit(p.units);
        }
    }
}

function toUnitWithError(crs) {
    mustBeString(crs);
    const u = toUnit(crs);
    if (u === undefined) {
        throw new Error(`No unit found for crs: '${crs}'`);
    }
    return u;
}

/**
 * This module provides basic methods to manipulate a CRS (as a string).
 *
 * @module CRS
 */
export default {
    /**
     * Units that can be used for a CRS.
     *
     * @enum {number}
     */
    UNIT,

    /**
     * Assert that the CRS is valid one.
     *
     * @param {string} crs - The CRS to validate.
     *
     * @throws {Error} if the CRS is not valid.
     */
    isValid(crs) {
        toUnitWithError(crs);
    },

    /**
     * Assert that the CRS is geographic.
     *
     * @param {string} crs - The CRS to validate.
     * @return {boolean}
     * @throws {Error} if the CRS is not valid.
     */
    isGeographic(crs) {
        return (toUnitWithError(crs) == UNIT.DEGREE);
    },

    /**
     * Assert that the CRS is using metric units.
     *
     * @param {string} crs - The CRS to validate.
     * @return {boolean}
     * @throws {Error} if the CRS is not valid.
     */
    isMetricUnit(crs) {
        return (toUnit(crs) == UNIT.METER);
    },

    /**
     * Get the unit to use with the CRS.
     *
     * @param {string} crs - The CRS to get the unit from.
     * @return {number} Either `UNIT.METER`, `UNIT.DEGREE`, `UNIT.FOOT` or `undefined`.
     */
    toUnit,

    /**
     * Is the CRS EPSG:4326 ?
     *
     * @param {string} crs - The CRS to test.
     * @return {boolean}
     */
    is4326,
    /**
     * Is the CRS geocentric ?
     * if crs isn't defined the method returns false.
     *
     * @param {string} crs - The CRS to test.
     * @return {boolean}
     */
    isGeocentric,

    /**
     * Give a reasonnable epsilon to use with this CRS.
     *
     * @param {string} crs - The CRS to use.
     * @return {number} 0.01 if the CRS is EPSG:4326, 0.001 otherwise.
     */
    reasonnableEpsilon(crs) {
        if (is4326(crs)) {
            return 0.01;
        } else {
            return 0.001;
        }
    },
    /**
     * format crs to European Petroleum Survey Group notation : EPSG:XXXX.
     *
     * @param      {string}  crs     The crs to format
     * @return     {string}  formated crs
     */
    formatToEPSG,
    /**
     * format crs to tile matrix set notation : TMS:XXXX.
     *
     * @param      {string}  crs     The crs to format
     * @return     {string}  formated crs
     */
    formatToTms,
    isTms,
    isEpsg,
    tms_3857: 'TMS:3857',
    tms_4326: 'TMS:4326',
    /**
     * Define a proj4 projection as a string and reference.
     *
     * @param {string}  code    code is the projection's SRS code (only used internally by the Proj4js library)
     * @param {string}  proj4def is the Proj4 definition string for the projection to use
     * @return {undefined}
     */
    defs: (code, proj4def) => proj4.defs(code, proj4def),
};

1	import proj4 from 'proj4';	1✔
2		1✔
3	proj4.defs('EPSG:4978', '+proj=geocent +datum=WGS84 +units=m +no_defs');	1✔
4		8,064✔
5	function isString(s) {	8,064✔
6	return typeof s === 'string' \|\| s instanceof String;	1!
7	}	4,303✔
8		4,303✔
9	function mustBeString(crs) {	4,303✔
10	if (!isString(crs)) {	4,303!
11	throw new Error(`Crs parameter value must be a string: '${crs}'`);	1✔
12	}	3,210✔
13	}	3,210✔
14		3,210✔
15	function isTms(crs) {	3,210✔
16	return isString(crs) && crs.startsWith('TMS');	1✔
17	}	551✔
18		551✔
19	function isEpsg(crs) {	551✔
20	return isString(crs) && crs.startsWith('EPSG');	1✔
21	}	422✔
22		422✔
23	function formatToTms(crs) {	422✔
24	mustBeString(crs);	422✔
25	return isTms(crs) ? crs : `TMS:${crs.match(/\d+/)[0]}`;	1✔
26	}	472✔
27		472✔
28	function formatToEPSG(crs) {	472✔
29	mustBeString(crs);	472✔
30	return isEpsg(crs) ? crs : `EPSG:${crs.match(/\d+/)[0]}`;	1✔
31	}	1✔
32		1✔
33	const UNIT = {	1✔
34	DEGREE: 1,	1✔
35	METER: 2,	3,103✔
36	FOOT: 3,	3,103✔
37	};	3,103✔
38		3,103✔
39	function is4326(crs) {	1✔
40	return crs === 'EPSG:4326';	827✔
41	}	827✔
42		827✔
43	function isGeocentric(crs) {	827✔
44	mustBeString(crs);	827✔
45	const projection = proj4.defs(crs);	827✔
46	return !projection ? false : projection.projName == 'geocent';	1✔
47	}	139✔
48		139✔
49	function _unitFromProj4Unit(projunit) {	139✔
50	if (projunit === 'degrees') {	139✔
51	return UNIT.DEGREE;	135✔
52	} else if (projunit === 'm' \|\| projunit === 'meter') {	135✔
53	return UNIT.METER;	1!
54	} else if (projunit === 'foot') {	1✔
55	return UNIT.FOOT;	1,295✔
56	} else {	1,295✔
57	return undefined;	1,295✔
58	}	1,295✔
59	}	1,295✔
UNCOV 60		×
UNCOV 61	function toUnit(crs) {	×
UNCOV 62	mustBeString(crs);	×
63	if (crs.startsWith('NAD')) {	1,295✔
64	return _unitFromProj4Unit(proj4.defs(crs).units);	1,295✔
65	}	384✔
66	switch (crs) {	384✔
67	case 'EPSG:4326' : return UNIT.DEGREE;	1,295✔
68	case 'EPSG:4978' : return UNIT.METER;	140!
69	default: {	140✔
70	const p = proj4.defs(crs.startsWith('NAD') ? crs : formatToEPSG(crs));	140!
71	if (!p) {	1,295✔
72	return undefined;	1✔
73	}	1,287✔
74	return _unitFromProj4Unit(p.units);	1,287✔
75	}	1,287✔
76	}	1✔
77	}	1✔
78		1✔
79	function toUnitWithError(crs) {	1✔
80	mustBeString(crs);	1,287✔
81	const u = toUnit(crs);	1✔
82	if (u === undefined) {	1✔
83	throw new Error(`No unit found for crs: '${crs}'`);	1✔
84	}	1✔
85	return u;	1✔
86	}	1✔
87		1✔
88	/**	1✔
89	* This module provides basic methods to manipulate a CRS (as a string).	1✔
90	*	1✔
91	* @module CRS	1✔
92	*/	1✔
93	export default {	1✔
94	/**	1✔
95	* Units that can be used for a CRS.	1✔
96	*	1✔
97	* @enum {number}	1✔
98	*/	1✔
99	UNIT,	1✔
100		1✔
101	/**	1✔
102	* Assert that the CRS is valid one.	1✔
103	*	1,270✔
104	* @param {string} crs - The CRS to validate.	1✔
105	*	1✔
106	* @throws {Error} if the CRS is not valid.	1✔
107	*/	1✔
108	isValid(crs) {	1✔
109	toUnitWithError(crs);	1✔
110	},	1✔
111		1✔
112	/**	1✔
113	* Assert that the CRS is geographic.	1✔
114	*	17✔
115	* @param {string} crs - The CRS to validate.	1✔
116	* @return {boolean}	1✔
117	* @throws {Error} if the CRS is not valid.	1✔
118	*/	1✔
119	isGeographic(crs) {	1✔
120	return (toUnitWithError(crs) == UNIT.DEGREE);	1✔
121	},	1✔
122		1✔
123	/**	4✔
124	* Assert that the CRS is using metric units.	4✔
125	*	1✔
126	* @param {string} crs - The CRS to validate.	1✔
127	* @return {boolean}	1✔
128	* @throws {Error} if the CRS is not valid.	1✔
129	*/	1✔
130	isMetricUnit(crs) {	1✔
131	return (toUnit(crs) == UNIT.METER);	1✔
132	},	1✔
133		1✔
134	/**	1✔
135	* Get the unit to use with the CRS.	1✔
136	*	1✔
137	* @param {string} crs - The CRS to get the unit from.	1✔
138	* @return {number} Either `UNIT.METER`, `UNIT.DEGREE`, `UNIT.FOOT` or `undefined`.	1✔
139	*/	1✔
140	toUnit,	1✔
141		1✔
142	/**	1✔
143	* Is the CRS EPSG:4326 ?	1✔
144	*	1✔
145	* @param {string} crs - The CRS to test.	1✔
146	* @return {boolean}	1✔
147	*/	1✔
148	is4326,	1✔
149	/**	1✔
150	* Is the CRS geocentric ?	1✔
151	* if crs isn't defined the method returns false.	1✔
152	*	1✔
153	* @param {string} crs - The CRS to test.	1✔
154	* @return {boolean}	2✔
155	*/	2✔
156	isGeocentric,	1✔
157		1✔
158	/**	1✔
159	* Give a reasonnable epsilon to use with this CRS.	1✔
160	*	1✔
161	* @param {string} crs - The CRS to use.	1✔
162	* @return {number} 0.01 if the CRS is EPSG:4326, 0.001 otherwise.	1✔
163	*/	1✔
164	reasonnableEpsilon(crs) {	1✔
165	if (is4326(crs)) {	1✔
166	return 0.01;	1✔
167	} else {	1✔
168	return 0.001;	1✔
169	}	1✔
170	},	1✔
171	/**	1✔
172	* format crs to European Petroleum Survey Group notation : EPSG:XXXX.	1✔
173	*	1✔
174	* @param {string} crs The crs to format	1✔
175	* @return {string} formated crs	1✔
176	*/	1✔
177	formatToEPSG,	1✔
178	/**	1✔
179	* format crs to tile matrix set notation : TMS:XXXX.	1✔
180	*	1✔
181	* @param {string} crs The crs to format	1✔
182	* @return {string} formated crs	1✔
183	*/	1✔
184	formatToTms,	1✔
185	isTms,	1✔
186	isEpsg,	1✔
187	tms_3857: 'TMS:3857',	1✔
UNCOV 188	tms_4326: 'TMS:4326',	×
189	/**	×
190	* Define a proj4 projection as a string and reference.	1✔
191	*	1✔
192	* @param {string} code code is the projection's SRS code (only used internally by the Proj4js library)	1✔
193	* @param {string} proj4def is the Proj4 definition string for the projection to use	1✔
194	* @return {undefined}	1✔
195	*/	1✔
196	defs: (code, proj4def) => proj4.defs(code, proj4def),	1✔
197	};	1✔

iTowns / itowns / 9957112168

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous