mirror of
https://github.com/acamarata/nrel-spa-dart.git
synced 2026-07-01 03:14:25 +00:00
77 lines
2.6 KiB
Markdown
77 lines
2.6 KiB
Markdown
# nrel_spa
|
|
|
|
[](https://pub.dev/packages/nrel_spa)
|
|
[](https://github.com/acamarata/nrel-spa-dart/actions/workflows/ci.yml)
|
|
[](LICENSE)
|
|
[](https://github.com/acamarata/nrel-spa-dart/wiki)
|
|
|
|
NREL Solar Position Algorithm for Dart and Flutter. Calculates solar zenith, azimuth, sunrise, sunset, and solar noon for any location and time. Pure Dart, zero dependencies.
|
|
|
|
Based on Reda & Andreas (2004), NREL/TP-560-34302. Accurate to ±0.0003 degrees.
|
|
|
|
## Installation
|
|
|
|
```yaml
|
|
dependencies:
|
|
nrel_spa: ^1.0.0
|
|
```
|
|
|
|
## Quick Start
|
|
|
|
```dart
|
|
import 'package:nrel_spa/nrel_spa.dart';
|
|
|
|
void main() {
|
|
final result = getSpa(
|
|
DateTime.utc(2024, 3, 15, 17, 0, 0),
|
|
40.7128, // latitude (NYC)
|
|
-74.0060, // longitude
|
|
-5.0, // UTC offset (EST)
|
|
);
|
|
|
|
print('Zenith: ${result.zenith.toStringAsFixed(4)}°');
|
|
print('Azimuth: ${result.azimuth.toStringAsFixed(4)}°');
|
|
print('Sunrise: ${result.sunrise.toStringAsFixed(4)} h');
|
|
print('Solar Noon: ${result.solarNoon.toStringAsFixed(4)} h');
|
|
print('Sunset: ${result.sunset.toStringAsFixed(4)} h');
|
|
}
|
|
```
|
|
|
|
## Custom Zenith Angles
|
|
|
|
Calculate rise/set times for any solar depression angle (twilight, prayer times, etc.):
|
|
|
|
```dart
|
|
final result = getSpa(
|
|
DateTime.utc(2024, 3, 15, 12, 0, 0),
|
|
40.7128, -74.0060, -5.0,
|
|
customAngles: [96.0, 102.0, 108.0], // civil, nautical, astronomical
|
|
);
|
|
|
|
for (final angle in result.angles) {
|
|
print('Rise: ${angle.sunrise}, Set: ${angle.sunset}');
|
|
}
|
|
```
|
|
|
|
## API
|
|
|
|
`getSpa(date, latitude, longitude, timezone, {...})` returns `SpaResult` with `zenith`, `azimuth`, `sunrise`, `solarNoon`, `sunset`, and `angles`. Use `calcSpa` for pre-formatted HH:MM:SS strings.
|
|
|
|
Full parameter reference and type definitions: [API Reference](https://github.com/acamarata/nrel-spa-dart/wiki/API-Reference).
|
|
|
|
## Compatibility
|
|
|
|
Dart SDK 3.7.0+. Works in Flutter, Dart CLI, and server-side Dart. Zero dependencies.
|
|
|
|
## Related
|
|
|
|
- [pray_calc_dart](https://github.com/acamarata/pray-calc-dart) - Islamic prayer times (uses nrel_spa)
|
|
- [nrel-spa](https://github.com/acamarata/nrel-spa) - JavaScript/TypeScript version (npm)
|
|
|
|
## Acknowledgments
|
|
|
|
> Reda, I. and Andreas, A. (2004). Solar Position Algorithm for Solar Radiation Applications. NREL/TP-560-34302. [DOI: 10.2172/15003974](https://doi.org/10.2172/15003974)
|
|
|
|
## License
|
|
|
|
[MIT](LICENSE). See LICENSE for NREL third-party notice.
|