illumipy is a Python module for estimating outside Illumination levels for given location, date and time.
Project description
illumipy is a Python module for estimating outside Illumination levels for given location, date and time. Requires an OpenWeatherMap API-key (see: https://openweathermap.org/appid)
Current limitations:
- cloud level, sunrise and sunset are not available for dates in the past. Results might therefore be unreliable. Times for sunrise and sunset will always be for the current day.
- at 100% cloud coverage, Results might be unreliable.
To use the module, simply import illumipy and call the function data.light_data(): This returns a dictionary object with the following information:
- ['illuminance']: Outside Brightness in Lux
- ['time']: Time used as %-H (e.g. 4 or 12)
- ['date']: Date used as YYYY-MM-DD
- ['city']: City Used
- ['country']: Country Used
- ['cloud_coverage']: Cloud coverage in %
- ['et_illuminance']: Extraterrestrial Illuminance in Lux
- ['direct_illuminance']: Direct Illuminance in Lux
- ['horizontal_illuminance']: Horizontal Illuminance in Lux
- ['horizontal_sky_illuminance']: Horizontal Sky Illuminance in Lux
- ['sunrise']: Time of Sunrise as hh:mm
- ['sunset']: Time of sunset as hh:mm
- ['sun_altitude']: Sund altitude at [Time] in degrees.
- ['day']: True if there is daylight at [Time].
It Takes the following arguments:
- time: str=[0-24], date: str=[YYYY-MM-DD], city: str=['City'], country: str=['Country'], api_key: str=['api key']
if no arguments are provided, defaults to values defined in defaults.py.
Requirements:
- Python3
- Python packages:
- requests
- logging
- math
- sys
- datetime
- argparse
- OpenWeatherMap API-Key
Author: Kalle Fornia
GitHub: https://github.com/duckwilliam/illumipy
PyPi: https://pypi.org/project/illumipy
Version: 1.0.8
10/2023
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for illumipy-1.0.93-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1c9aa84173b3bcc73f9f0a477a6bd8b4c44139a6e8fe5bbcab9ad1dbc5f87492 |
|
MD5 | a177bccc28377aea9b3c442637cf39bd |
|
BLAKE2b-256 | 2a2b3963333fc7703d07917bba4b16d94381cf82c82d50ab4e0742c55622d018 |