mirror of
https://github.com/MichMich/MagicMirror.git
synced 2025-06-27 17:01:08 -04:00
## [2.29.0] - 2024-10-01 Thanks to: @bugsounet, @dkallen78, @jargordon, @khassel, @KristjanESPERANTO, @MarcLandis, @rejas, @ryan-d-williams, @sdetweil, @skpanagiotis. > ⚠️ This release needs nodejs version `v20` or `v22`, minimum version is `v20.9.0` ### Added - [compliments] Added support for cron type date/time format entries mm hh DD MM dow (minutes/hours/days/months and day of week) see https://crontab.cronhub.io for construction (#3481) - [core] Check config at every start of MagicMirror² (#3450) - [core] Add spelling check (cspell): `npm run test:spelling` and handle spelling issues (#3544) - [core] removed `config.paths.vendor` (could not work because `vendor` is hardcoded in `index.html`), renamed `config.paths.modules` to `config.foreignModulesDir`, added variable `MM_CUSTOMCSS_FILE` which - if set - overrides `config.customCss`, added variable `MM_MODULES_DIR` which - if set - overrides `config.foreignModulesDir`, added test for `MM_MODULES_DIR` (#3530) - [core] elements are now removed from `index.html` when loading script or stylesheet files fails - [core] Added `MODULE_DOM_UPDATED` notification each time the DOM is re-rendered via `updateDom` (#3534) - [tests] added minimal needed node version to tests (currently v20.9.0) to avoid releases with wrong node version info - [tests] Added `node-libgpiod` library to electron-rebuild tests (#3563) ### Removed - [core] removed installer only files (#3492) - [core] removed raspberry object from systeminformation (#3505) - [linter] removed `eslint-plugin-import`, because it doesn't support ESLint v9. We will reenter it later when it does. - [tests] removed `onoff` library from electron-rebuild tests (#3563) ### Updated - [weather] Updated `apiVersion` default from 2.5 to 3.0 (#3424) - [core] Updated dependencies including stylistic-eslint - [core] nail down `node-ical` version to `0.18.0` with exception `allow-ghsas: GHSA-8hc4-vh64-cxmj` in `dep-review.yaml` (which should removed after next `node-ical` update) - [core] Updated SocketIO catch all to new API - [core] Allow custom modules positions by scanning index.html for the defined regions, instead of hard coded (PR #3518 fixes issue #3504) - [core] Detail optimizations in `config_check.js` - [core] Updated minimal needed node version in `package.json` (currently v20.9.0) (#3559) and except for v21 (no security updates) (#3561) - [linter] Switch to ESLint v9 and flat config and replace `eslint-plugin-unicorn` by `@eslint/js` - [core] fix discovering module positions twice after #3450 ### Fixed - Fixed `checks` badge in README.md - [weather] Fixed issue with the UK Met Office provider following a change in their API paths and header info. - [core] add check for node_helper loading for multiple instances of same module (#3502) - [weather] Fixed issue for respecting unit config on broadcasted notifications - [tests] Fixes calendar test by moving it from e2e to electron with fixed date (#3532) - [calendar] fixed sliceMultiDayEvents getting wrong count and displaying incorrect entries, Europe/Berlin (#3542) - [tests] ignore `js/positions.js` when linting (this file is created at runtime) - [calendar] fixed sliceMultiDayEvents showing previous day without config enabled --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: Michael Teeuw <michael@xonaymedia.nl> Co-authored-by: Kristjan ESPERANTO <35647502+KristjanESPERANTO@users.noreply.github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Ross Younger <crazyscot@gmail.com> Co-authored-by: Veeck <github@veeck.de> Co-authored-by: Bugsounet - Cédric <github@bugsounet.fr> Co-authored-by: jkriegshauser <joshuakr@nvidia.com> Co-authored-by: illimarkangur <116028111+illimarkangur@users.noreply.github.com> Co-authored-by: sam detweiler <sdetweil@gmail.com> Co-authored-by: vppencilsharpener <tim.pray@gmail.com> Co-authored-by: veeck <michael.veeck@nebenan.de> Co-authored-by: Paranoid93 <6515818+Paranoid93@users.noreply.github.com> Co-authored-by: Brian O'Connor <btoconnor@users.noreply.github.com> Co-authored-by: WallysWellies <59727507+WallysWellies@users.noreply.github.com> Co-authored-by: Jason Stieber <jrstieber@gmail.com> Co-authored-by: jargordon <50050429+jargordon@users.noreply.github.com> Co-authored-by: Daniel <32464403+dkallen78@users.noreply.github.com> Co-authored-by: Ryan Williams <65094007+ryan-d-williams@users.noreply.github.com> Co-authored-by: Panagiotis Skias <panagiotis.skias@gmail.com> Co-authored-by: Marc Landis <dirk.rettschlag@gmail.com>
169 lines
5.5 KiB
JavaScript
169 lines
5.5 KiB
JavaScript
const WeatherUtils = {
|
|
|
|
/**
|
|
* Convert wind (from m/s) to beaufort scale
|
|
* @param {number} speedInMS the windspeed you want to convert
|
|
* @returns {number} the speed in beaufort
|
|
*/
|
|
beaufortWindSpeed (speedInMS) {
|
|
const windInKmh = this.convertWind(speedInMS, "kmh");
|
|
const speeds = [1, 5, 11, 19, 28, 38, 49, 61, 74, 88, 102, 117, 1000];
|
|
for (const [index, speed] of speeds.entries()) {
|
|
if (speed > windInKmh) {
|
|
return index;
|
|
}
|
|
}
|
|
return 12;
|
|
},
|
|
|
|
/**
|
|
* Convert a value in a given unit to a string with a converted
|
|
* value and a postfix matching the output unit system.
|
|
* @param {number} value - The value to convert.
|
|
* @param {string} valueUnit - The unit the values has. Default is mm.
|
|
* @param {string} outputUnit - The unit system (imperial/metric) the return value should have.
|
|
* @returns {string} - A string with tha value and a unit postfix.
|
|
*/
|
|
convertPrecipitationUnit (value, valueUnit, outputUnit) {
|
|
if (valueUnit === "%") return `${value.toFixed(0)} ${valueUnit}`;
|
|
|
|
let convertedValue = value;
|
|
let conversionUnit = valueUnit;
|
|
if (outputUnit === "imperial") {
|
|
convertedValue = this.convertPrecipitationToInch(value, valueUnit);
|
|
conversionUnit = "in";
|
|
} else {
|
|
conversionUnit = valueUnit ? valueUnit : "mm";
|
|
}
|
|
|
|
return `${convertedValue.toFixed(2)} ${conversionUnit}`;
|
|
},
|
|
|
|
/**
|
|
* Convert precipitation value into inch
|
|
* @param {number} value the precipitation value for convert
|
|
* @param {string} valueUnit can be 'mm' or 'cm'
|
|
* @returns {number} the converted precipitation value
|
|
*/
|
|
convertPrecipitationToInch (value, valueUnit) {
|
|
if (valueUnit && valueUnit.toLowerCase() === "cm") return value * 0.3937007874;
|
|
else return value * 0.03937007874;
|
|
},
|
|
|
|
/**
|
|
* Convert temp (from degrees C) into imperial or metric unit depending on
|
|
* your config
|
|
* @param {number} tempInC the temperature in celsius you want to convert
|
|
* @param {string} unit can be 'imperial' or 'metric'
|
|
* @returns {number} the converted temperature
|
|
*/
|
|
convertTemp (tempInC, unit) {
|
|
return unit === "imperial" ? tempInC * 1.8 + 32 : tempInC;
|
|
},
|
|
|
|
/**
|
|
* Convert wind speed into another unit.
|
|
* @param {number} windInMS the windspeed in meter/sec you want to convert
|
|
* @param {string} unit can be 'beaufort', 'kmh', 'knots, 'imperial' (mph)
|
|
* or 'metric' (mps)
|
|
* @returns {number} the converted windspeed
|
|
*/
|
|
convertWind (windInMS, unit) {
|
|
switch (unit) {
|
|
case "beaufort":
|
|
return this.beaufortWindSpeed(windInMS);
|
|
case "kmh":
|
|
return (windInMS * 3600) / 1000;
|
|
case "knots":
|
|
return windInMS * 1.943844;
|
|
case "imperial":
|
|
return windInMS * 2.2369362920544;
|
|
case "metric":
|
|
default:
|
|
return windInMS;
|
|
}
|
|
},
|
|
|
|
/*
|
|
* Convert the wind direction cardinal to value
|
|
*/
|
|
convertWindDirection (windDirection) {
|
|
const windCardinals = {
|
|
N: 0,
|
|
NNE: 22,
|
|
NE: 45,
|
|
ENE: 67,
|
|
E: 90,
|
|
ESE: 112,
|
|
SE: 135,
|
|
SSE: 157,
|
|
S: 180,
|
|
SSW: 202,
|
|
SW: 225,
|
|
WSW: 247,
|
|
W: 270,
|
|
WNW: 292,
|
|
NW: 315,
|
|
NNW: 337
|
|
};
|
|
|
|
return windCardinals.hasOwnProperty(windDirection) ? windCardinals[windDirection] : null;
|
|
},
|
|
|
|
convertWindToMetric (mph) {
|
|
return mph / 2.2369362920544;
|
|
},
|
|
|
|
convertWindToMs (kmh) {
|
|
return kmh * 0.27777777777778;
|
|
},
|
|
|
|
calculateFeelsLike (temperature, windSpeed, humidity) {
|
|
const windInMph = this.convertWind(windSpeed, "imperial");
|
|
const tempInF = this.convertTemp(temperature, "imperial");
|
|
let feelsLike = tempInF;
|
|
|
|
if (windInMph > 3 && tempInF < 50) {
|
|
feelsLike = Math.round(35.74 + 0.6215 * tempInF - 35.75 * Math.pow(windInMph, 0.16) + 0.4275 * tempInF * Math.pow(windInMph, 0.16));
|
|
} else if (tempInF > 80 && humidity > 40) {
|
|
feelsLike
|
|
= -42.379
|
|
+ 2.04901523 * tempInF
|
|
+ 10.14333127 * humidity
|
|
- 0.22475541 * tempInF * humidity
|
|
- 6.83783 * Math.pow(10, -3) * tempInF * tempInF
|
|
- 5.481717 * Math.pow(10, -2) * humidity * humidity
|
|
+ 1.22874 * Math.pow(10, -3) * tempInF * tempInF * humidity
|
|
+ 8.5282 * Math.pow(10, -4) * tempInF * humidity * humidity
|
|
- 1.99 * Math.pow(10, -6) * tempInF * tempInF * humidity * humidity;
|
|
}
|
|
|
|
return ((feelsLike - 32) * 5) / 9;
|
|
},
|
|
|
|
/**
|
|
* Converts the Weather Object's values into imperial unit
|
|
* @param {object} weatherObject the weather object
|
|
* @returns {object} the weather object with converted values to imperial
|
|
*/
|
|
convertWeatherObjectToImperial (weatherObject) {
|
|
if (!weatherObject || Object.keys(weatherObject).length === 0) return null;
|
|
|
|
let imperialWeatherObject = { ...weatherObject };
|
|
|
|
if (imperialWeatherObject) {
|
|
if (imperialWeatherObject.feelsLikeTemp) imperialWeatherObject.feelsLikeTemp = this.convertTemp(imperialWeatherObject.feelsLikeTemp, "imperial");
|
|
if (imperialWeatherObject.maxTemperature) imperialWeatherObject.maxTemperature = this.convertTemp(imperialWeatherObject.maxTemperature, "imperial");
|
|
if (imperialWeatherObject.minTemperature) imperialWeatherObject.minTemperature = this.convertTemp(imperialWeatherObject.minTemperature, "imperial");
|
|
if (imperialWeatherObject.precipitationAmount) imperialWeatherObject.precipitationAmount = this.convertPrecipitationToInch(imperialWeatherObject.precipitationAmount, imperialWeatherObject.precipitationUnits);
|
|
if (imperialWeatherObject.temperature) imperialWeatherObject.temperature = this.convertTemp(imperialWeatherObject.temperature, "imperial");
|
|
if (imperialWeatherObject.windSpeed) imperialWeatherObject.windSpeed = this.convertWind(imperialWeatherObject.windSpeed, "imperial");
|
|
}
|
|
|
|
return imperialWeatherObject;
|
|
}
|
|
};
|
|
|
|
if (typeof module !== "undefined") {
|
|
module.exports = WeatherUtils;
|
|
}
|