node-red-contrib-sunpos 1.3.0

A Node-RED node that provides the position of the sun

npm install node-red-contrib-sunpos

npm version

A Node-RED node to calculate the position of the sun at a given location.

Install

Run the following command in the root directory of your Node-RED install

npm install node-red-contrib-sunpos

Usage

This node calculates the position of the sun at a given location. It is configured with the following properties:

  • lat: latitude of the location
  • lon: longitude of the location
  • start: time of day that constitutes the start of daylight hours
  • startOffset: offset to be applied for start of daylight hours, a negative value brings the start forward, a positive value delays
  • end: time of day that constitutes the end of daylight hours
  • endOffset: offset to be applied for end of daylight hours

This node can optionally receive a time via an input message containing msg.time conforming to Javascript Date object, otherwise it will use the current time.

This node emits a msg.payload with the following properties:

  • sunInSky: boolean value indicating whether it is currently considered daylight hours
  • altitude: altitude of the sun above the horizon in degrees
  • azimuth: azimuth of the sun in degrees, where 0 is North
  • altitudeRadians: altitude of the sun above the horizon in radians
  • azimuthRadians: azimuth of the sun in radians, where 0 is South, a positive value is in the west and negative value in the east

The node also sets msg.location with the coordinates of the location and msg.topic to "sun".

The node also reports its status within the Node-RED flow editor, using colour to indicate whether it is currently considered daylight hours.

Credit

This Node is based on, and has used code from, another node-RED Node called suncalc published by dceejay

Node Info

Version: 1.3.0
Updated 3 months ago
License: Apache-2.0

Downloads

1 in the last day
35 in the last week
219 in the last month

Nodes

  • sunpos

Keywords

  • node-red
  • sunpos
  • suncalc

Maintainers

  • alisdairjsmyth