almostengr / farmosnws

Automated importing of NWS weather into FarmOS

FarmOS NWS

Automated importing of National Weather Service (NWS) data into FarmOS.

Purpose

The purpose of this project is to allow FarmOS to use data from the National Weather Service to allow it to make better decisions as well as to log data from a trusted weather source.

Using data from the National Weather Service reduces the cost to get a FarmOS installation going as temperature, rain, humidity and other sensors do not have to be purchased. Furthermore, it reduces the maintenance costs by reducing the amount of infrastructure required to maintain the farm or garden.

System Requirements

• Drupal 7
• FarmOS
• Internet connection

Installation

Clone the Repository

To get the latest release, clone this repository by running the command below

git clone https://github.com/almostengr/farmosnws.git

Within your Drupal site, enable the FarmOS NWS and FarmOS NWS Feeds Importer modules from the Modules page.

Configure FarmOS NWS

After enabling the modules, go to the FarmOS NWS configuration page (Admin > Configuration > Web Services > FarmOS NWS Settings). Enter the file system location, weather locations that you would like weather imported for, measurement units, and whether you want to keep files after they have been loaded. When done, click Save.

Configure Feed Importer

Within your Drupal site, go to the feed importer page (Structure > Feeds Importers > Log: NWS Observation). In the Fetcher section, set the upload directory to the same directory that you defined in the Configure FarmOS NWS section. When done, click Save.

Uninstallation

Within your Drupal site, go to the Modules page and disable FarmOS NWS and FarmOS NWS Importer modules and click Save Configuration. Then go to the Uninstall page (Modules > Uninstall), select each module, and click Uninstall.

If you uninstall the modules, the data that was imported by the modules WILL NOT be removed. If you wish to remove the data that was imported, you will have to manually remove each entry.

Code Updates

To get the latest version of this code, pull the latest release from the FarmOS NWS GitHub Page.

Alternatively you can get the latest code by going to the directory that contains the code and running the commands below:

git checkout 7.x-2.x
git pull origin 7.x-2.x

Development Version

To get the latest development version of the code, pull the latest dev release from the https://github.com/almostengr/farmosnws/tree/7.x-2.x-dev. Development versions of the code may not be stable and are not recommended to be used in Production environments.

Alternatively, you can get the latest development code by going to the directory that contains the code and running the commands below:

git checkout 7.x-2.x-dev
git pull origin 7.x-2.x-dev

Author

Kenny Robinson, @almostengr http://thealmostengineer.com

Additional Information

Bugs and enhancements will be tracked using the Issue tracker on the project repo.

Project is available under the MIT License. See LICENSE for more information.

For more information about FarmOS, please visit the FarmOS website.

For more information about the National Weather Service (NWS), please visit the NWS website.

farmosnws's Issues

Update ReadMe file to include setup instructions

if condition not working in shell script

The if condition that is in place to make sure that the shell script does not run if a file is not provided does not actually check when tested.

create youtube video demonstrating setup

create documentation using mkdocs

processed feeds not delete

Processed feeds are not being deleted even when the option has been selected on the admin form.

Wrong variable is being checked, thus resulting in none of the feeds being removed after being processed.

Combine watchdog and Drupal set message

The functions can be combined so that one call can be made instead of two calls when errors occur.

Link on farmOS.org

Hi @bitsecondal ! Thanks for creating this module!

Would you like me to add a link to it on farmOS.org?

It would appear under "Other modules" on this page: http://farmos.org/development/projects/

I would be happy to add your name/organization to the list of farmOS supporters too, if you'd like: http://farmos.org/community/supporters/

use Features

Features offers faster build time for creating and testing the module. FarmOS is already packaged with Features module.

update module url

Add "project status url" so that the module can be updated from drupal.

Cron restriction

Restriction should be defined to prevent same data from being loaded more than once within the same hour.

Allow selection of data to save

Allow the user to to select the data elements that they wish to save from the feed.

Email notifications

Email notifications need to be set up

include code for rules

Include the code that will import the data from node type into FarmOS format.

Create Sensor for each location

Each location should be represented by its own sensor in FarmOS. This will allow for all the data collected from a particular location to be viewed from the sensor view.

upload data as NWS user

Create account upon module installation. This will allow for the data that is uploaded by the module to be distinguished from other data loaded into the system by other means.

have feeds pulled using cron queue

Given the infinite number of feeds that can be pulled, the feeds should be pulled using a cron queue.

Allow for both measurement units

Allow for loading US and Metric units from the feed.

Update to latest version

Shell script to generate feed file

Update the script to be able to generate a configuration file for use of the shell script.

Message regarding hourly cron

If module doesn't have cron set to hourly, then message needs to be displayed so that the setting can be updated. Data feeds are updated hourly, therefore should be pulled at this frequency.