11175912299

Committed 04 Oct 2024 07:34AM UTC coverage: 87.09% (+0.1%) from 86.944%

Build # 11175912299

Build Type

Pull #2422

github

Committed by

web-flow

Commit Message

Merge add66c850 into c862ca737

Pull Request Pull Request #2422: Preparation for PR reprojection 'a la volee'

Run Details

2810 of 3730 branches covered (75.34%)

Branch coverage included in aggregate %.

38 of 43 new or added lines in 5 files covered. (88.37%)

5 existing lines in 2 files now uncovered.

24512 of 27642 relevant lines covered (88.68%)

1184.15 hits per line

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

96.54

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

iTowns / itowns / 11175912299

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