Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/brycejohnston/agroclimatology
Ruby client for interacting with the NASA (POWER) Agroclimatology Web Resource
https://github.com/brycejohnston/agroclimatology
agriculture climate nasa ruby solar-radiation
Last synced: about 1 month ago
JSON representation
Ruby client for interacting with the NASA (POWER) Agroclimatology Web Resource
- Host: GitHub
- URL: https://github.com/brycejohnston/agroclimatology
- Owner: brycejohnston
- License: mit
- Created: 2016-05-18T14:02:15.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-08-30T14:01:30.000Z (about 7 years ago)
- Last Synced: 2024-04-13T20:52:28.817Z (5 months ago)
- Topics: agriculture, climate, nasa, ruby, solar-radiation
- Language: Ruby
- Homepage: https://rubygems.org/gems/agroclimatology
- Size: 17.6 KB
- Stars: 17
- Watchers: 4
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- -awesome-agriculture - agroclimatology - Ruby client for interacting with the NASA (POWER) Agroclimatology Web Resource. (Climate, Environment and Weather)
README
# Agroclimatology
[][gem]
[][travis]
[gem]: https://rubygems.org/gems/agroclimatology
[travis]: http://travis-ci.org/beaorn/agroclimatology
Ruby client for interacting with the [NASA (POWER) Agroclimatology Web Resource](http://power.larc.nasa.gov/cgi-bin/agro.cgi)
Initial functionality is focused on getting solar radiation data
for a given latitude and longitude. Other solar radiation and meteorological
query parameters will be available in subsequent versions.
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'agroclimatology'
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install agroclimatology
## Usage
Required params
- latitude
- longitude
Optional params
- year_start (default: 1983)
- year_end (default: current year)
```ruby
Agroclimatology.fetch(latitude, longitude, year_start, year_end)
```
### Examples
Fetch all solar radiation data
```ruby
Agroclimatology.fetch(37.752798, -100.017079)
```
Fetch solar radiation data from 2015 - 2016
```ruby
Agroclimatology.fetch(-26.660446, 152.964647, 2015, 2016)
```
```ruby
[
{
:year => "2015",
:day_of_year => "1",
:rad_atmosphere => "42.84",
:rad_surface => "27.47",
:rad_flux => "34.78"
},
{
:year => "2015",
:day_of_year => "2",
:rad_atmosphere => "43.27",
:rad_surface => "23.00",
:rad_flux => "34.81"
},
]
```
### Output
Ruby object containing array of hashes for every day included in year_start - year_end range
- **year** - Year
- **day_of_year** - Day of Year
- **rad_atmosphere** - Average Top-of-atmosphere Insolation (MJ/m^2/day)
- **rad_surface** - Average Insolation Incident On A Horizontal Surface (MJ/m^2/day)
- **rad_flux** - Average Downward Longwave Radiative Flux (MJ/m^2/day)
## Development
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment. To install this gem onto your local machine, run `bundle exec rake install`.
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/beaorn/agroclimatology.
## Acknowledgments
Data provided by [NASA (POWER) Agroclimatology Web Resource](http://power.larc.nasa.gov/cgi-bin/agro.cgi)
## License
The gem is available as open source under the terms of the MIT License (see [LICENSE.txt](https://github.com/beaorn/agroclimatology/blob/master/LICENSE.txt))