feels  
==========
   

Feels allow you to calculate apparent temperature using heat index, approximate wet-bulb globe temperature, humidex, australian apparent temperature and wind chill.

Combinations of this methods also named as Feels like, Real feel etc.

You can also convert temperature, speed and calculate relative humidity, dew point, frost point, water vapour pressure using class or standalone methods.

Usage

``sh
$ npm install feels --save
`

`javascript
const Feels = require('feels');

const config = {
temp: 20,
humidity: 85,
speed: 20,
units: {
temp: 'c',
speed: 'mps'
}
};

new Feels(config).like();
`

Quick navigation

#### Params:
options (Object*) - Feels options:
temp (Float*) - Temperature in Celsius, Fahrenheit or Kelvin, depends on units type.
humidity (Float*) - Relative humidity in percent.
speed (Float*) - Wind speed in meters per second, miles per hour or kilometers per hour, depends on units type.
dewPoint (Float*) - Dew point in Celsius, Fahrenheit, Kelvin depends on units type.
wvp (Float*) - Water vapour pressure in hPa.
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.
units (Object*) - Units type:
temp (String*) - c, f, k (by default c).
speed (String*) - mps, mph, kph (by default mps).

`javascript
const Feels = require('feels');

new Feels({ temp: 20, humidity: 80.9 }).toF().humidex();
`

$3

Sets the options.

#### Params:
options (Object*) - Feels options:
temp (Float*) - Temperature in Celsius, Fahrenheit or Kelvin, depends on units type.
humidity (Float*) - Relative humidity in percent.
speed (Float*) - Wind speed in meters per second, miles per hour or kilometers per hour, depends on units type.
dewPoint (Float*) - Dew point in Celsius, Fahrenheit, Kelvin depends on units type.
wvp (Float*) - Water vapour pressure in hPa.
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.
units (Object*) - Units type:
temp (String*) - c, f, k (by default c).
speed (String*) - mps, mph, kph (by default mps).

`javascript
const Feels = require('feels');
const feels = new Feels();
const config = {
temp: 20,
humidity: 85,
speed: 20,
units: {
temp: 'c',
speed: 'mps'
}
};

feels.setOptions(config);
feels.AAT();
`

$3

Calculates apparent temperature using specified methods.

If methods aren't provided returns an index which is calculated with ['HI', 'HI_CA', 'AAT', 'WCI'].

#### Params:
[methods] (String|Array*) - String or array with one of the apparent temperature acronyms.

$3

If you want to convert temperature from one to other temperature scale, you can place .toC(), .toF() or .toK() before target method.

`javascript
new Feels(config).toF().like(['AAT', 'HI_CA']);
`

$3

Adds new method, which can be used by itself or in .like().

#### Params:
name (String*) - Method name.
method (Function*) - The method itself.

`javascript
const feels = new Feels();
feels.addMethod('newbie', () => (feels.heatIndex() + feels.humidex()) / 2);
feels.addMethod('newbie2', function () {
return (this.heatIndex() + this.humidex()) / 2;
});

feels.setOptions({ temp: 20, dewPoint: 18 });
feels.newbie();
feels.like(['AAT', 'newbie2']);
`

$3

Allows you to create your own methods which can be used in .like(), by inheriting the base class.

#### Params:
methods (Array*) - Method names.

`javascript
class NewFeels extends Feels {
constructor(opts) {
super(opts);
this.registerMethods(['newbie', 'newbie2']);
}
newbie() {
return (this.heatIndex() + this.humidex()) / 2;
}
newbie2() {
return (this.heatIndex() + this.humidex()) / 2;
}
}

const feels = new NewFeels({ temp: 20, dewPoint: 18 });

feels.newbie();
feels.like(['AAT', 'newbie2']);
`

$3

`javascript
const Feels = require('feels');

Feels.humidex(20, 80.9);
`

Temperature convert

$3

#### Params:
temp (Float*) - Temperature.
from (String*) - c - Celsius, f - Fahrenheit, k - Kelvin.
to (String*) - c - Celsius, f - Fahrenheit, k - Kelvin.
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.

`javascript
const Feels = require('feels');
const humidex = Feels.humidex(20, 80.9);

Feels.tempConvert(humidex, 'c', 'f');
`

Speed convert

$3

#### Params:
speed (Float*) - Speed.
from (String*) - mps - Metre per second, mph - Miles per hour, kph - Kilometre per hour.
to (String*) - mps - Metre per second, mph - Miles per hour, kph - Kilometre per hour.
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.

`javascript
const Feels = require('feels');
const speed = Feels.speedConvert(36, 'kph', 'mps');

Feels.AAT(20, speed, 89);
`

Heat index

The heat index is an index that combines air temperature and relative humidity in an attempt to determine the human-perceived equivalent temperature. Wiki

Note: The heat index is used for temperatures more than 20 Celsius.

$3

#### Params:
temp (Float*) - Temperature in Celsius.
humidity|dewPoint (Float*) - Humidity in percent (0 > humidity <= 100) or Dew point in Celsius.
[options] (Object*) - Object with options:
dewPoint (True*) - Must be true for dew point usage.
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.

Approximate WBGT

The approximate wet-bulb globe temperature is a composite temperature used to estimate the effect of temperature, humidity, wind speed on humans. Unlike WBGT, AWBGT not take into account radiation effect. Wiki

Note: The AWBGT is used for temperatures more than 15 Celsius.

$3

#### Params:
temp (Float*) - Temperature in Celsius.
humidity|dewPoint (Float*) - Humidity in percent (0 > humidity <= 100) or Dew point in Celsius.
[options] (Object*) - Object with options:
dewPoint (True*) - Must be true for dew point usage.
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.

Humidex

The humidex is an index number used by Canadian meteorologists to describe how hot the weather feels to the average person, by combining the effect of heat and humidity. Wiki

Note: The humidex is used for temperatures more than 0 Celsius.

$3

#### Params:
temp (Float*) - Temperature in Celsius.
humidity|dewPoint (Float*) - Humidity in percent (0 > humidity <= 100) or Dew point in Celsius.
[options] (Object*) - Object with options:
dewPoint (True*) - Must be true for dew point usage.
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.

Australian Apparent Temperature

The AAT is an index number used by the Australian Bureau of Meteorology to describe heat balance in the human body. Wiki

$3

#### Params:
temp (Float*) - Temperature in Celsius.
speed (Float*) - Speed in meters per second.
humidity|dewPoint (Float*) - Humidity in percent (0 > humidity <= 100) or Dew point in Celsius.
[options] (Object*) - Object with options:
dewPoint (True*) - Must be true for dew point usage.
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.

Wind chill

Wind chill is the perceived decrease in air temperature felt by the body on exposed skin due to the flow of air. Wiki

Note: The humidex is used for temperatures less than 0 Celsius.

$3

#### Params:
temp (Float*) - Temperature in Celsius.
speed (Float*) - Speed in meters per second.
[options] (Object*) - Object with options:
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.

Water vapour pressure

$3

#### Params:
temp (Float*) - Temperature in Celsius.
humidity (Integer*) - Humidity in percent (0 > humidity <= 100).
[options] (Object*) - Object with options:
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.

$3

#### Params:
dewPoint (Float*) - Dew point in Celsius.
[options] (Object*) - Object with options:
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.

Approximate relative humidity

$3

#### Params:
temp (Float*) - Temperature in Celsius.
dewPoint (Float*) - Dew point in Celsius.
[options] (Object*) - Object with options:
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.

Relative humidity

$3

#### Params:
temp (Float*) - Temperature in Celsius.
WVP|dewPoint (Float*) - Water vapour pressure or Dew point in Celsius.
[options] (Object*) - Object with options:
dewPoint (True*) - Must be true for dew point usage.
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.

Approximate dew point

$3

#### Params:
temp (Float*) - Temperature in Celsius.
humidity (Integer*) - Humidity in percent (0 > humidity <= 100).
[options] (Object*) - Object with options:
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.

Dew point

$3

#### Params:
temp (Float*) - Temperature in Celsius.
humidity (Integer*) - Humidity in percent (0 > humidity <= 100).
[options] (Object*) - Object with options:
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round.

Frost point

$3

#### Params:
temp (Float*) - Temperature in Celsius.
humidity (Integer*) - Humidity in percent (0 > humidity <= 100).
[options] (Object*) - Object with options:
round (Boolean|Function*) - The function that will be used to round the result. If true, rounds the result using Math.round`.

License

The MIT License (MIT)

Copyright (c) 2015-2018 Alexey Bystrov