ORNL-Weather

NCEI/NOAA Local Climatological Data Retrieval

About

This program is for requesting Local Climatological weather data from the National Centers for Environmental Information (NCEI). Similarly to NOAA LCD Website, this program gives the user the option to select one or more weather stations they wish to receive data from, choose their desired data types, select the timeframe over which they need their data, and provides the data to the user in the form of a downloadable csv or json file. Unlike NOAA's built-in tool, this program allows the user to instantly receive this data rather than waiting for NCEI to send it via email. This program also includes additional functions not found in NOAA's built-in tool, including but not limited to searching for stations within a specified distance, selecting specific data types, displaying additional information about available data types, and removal of entries that are missing relevant data.

Dependencies

• Node.js v14.15.0 or higher
• Angular CLI

Bugs/Non-Working Features

• Please report bugs to armstrongko@ornl.gov

Installation - Local

Windows

• To install as a Windows program, download and run ORNL-Weather-Setup executable from latest release here and follow installation wizard.
• To run without installing, download ORNL-Weather-x.y.z-win.zip from latest release here, unzip folder, then run ORNL-Weather.exe.
• Note: Windows may display SmartScreen warnings when launching for the first time. Simply choose "Run anyway".

macOS

• To run from DMG, download .dmg file from latest release here, open the file in Finder, drag ORNL-Weather to Applications at the prompt, then open from Applications.
• To run from zip, download ORNL-Weather-x.y.z-mac.zip from latest release here, then open by double clicking to launch the application.
• Note: Pop-ups that appear during the first run can be ignored and should not reappear on subsequent launches.
• Note: Downloaded files will not properly open unless opened in Finder.

Linux

• To run from AppImage, download .AppImage file from latest release here, open .AppImage file Properties>Permissions and ensure "Allow executing of file as program" is checked, then double-click the file to launch the application.

Installation - Server

• First download and install node.js from above link.
• Open a command line and navigate to the product source code folder.
• Run npm install -g @angular/cli to install angular.
• Run npm install to install all the packages required for the program.
• Run command ng build --base-href /weather/, replacing "weather" with desired subdirectory name.
• Place contents of dist/ornl-weather/ directory into new folder in html server folder (ex. /var/www/html/)

Example (Ubuntu, Apache2)

curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash
source ~/.profile
nvm install node
wget https://github.com/ORNL-AMO/ORNL-Weather/archive/refs/tags/1.2.1.tar.gz
tar -xf 1.2.1.tar.gz
cd ORNL-Weather-1.2.1/
npm install
npm install -g @angular/cli
ng build --base-href /weather/
sudo mv ./dist/ornl-weather /var/www/html/weather
sudo systemctl restart apache2

For Developers

Build Local Installer, Executable

• To install all required packages:
• First download and install Node.js from above link.
• Open a command line and navigate to the product source code folder.
• Run npm install -g @angular/cli to install angular.
• Run npm install to install all the packages required for the program.
• Run command npm run dist to build project
• Windows: Installer (ORNL-Weather-Setup-x.y.z.exe) and zip containing executable (ORNL-Weather-x.y.z-win) can be found in ORNL-Weather\output.
• macOS: DMG (ORNL-Weather-x.y.z.dmg) and zip containing application (ORNL-Weather-x.y.z-mac.zip) can be found in ORNL-Weather/output/.
• Linux: AppImage (ORNL-Weather-x.y.z.AppImage) and tarball containing application (ORNL-Weather-x.y.z-linux.tar.gz) can be found in ORNL-Weather/output/.

Build Development Server

• To install all required packages:
• First download and install Node.js from above link.
• Open a command line and navigate to the product source code folder.
• Run npm install -g @angular/cli to install angular.
• Run npm install to install all the packages required for the program.
• Finally run ng serve to run dev server and navigate to http://localhost:4200/
• Run ng serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.
• Run ng generate component component-name to generate a new component. You can also use ng generate directive|pipe|service|class|guard|interface|enum|module.
• For more information, see the angular docs

Special Information

This program has been made by senior Computer Science students from Tennessee Technological University for our Capstone Project. We would like to give our thanks to the Oak Ridge National Labs Team that worked with us on this project and giving us great experience for our future careers and working in an Agile environment and team.

Tennessee Tech University Team Members

• Tavian Dodd
• Chandler Hendrick
• Brian Kemp
• Bryce McDonald
• Grant Qualls

Sources

• Zip Code data compiled from data provided by GeoNames and The United States Census Bureau
• City information provided by kelvins/US-Cities-Database
• Stations information provided by National Climatic Data Center
• Local Climatological Data provided by National Centers for Environmental Information
• Additional information regarding the Local Climatological Data dataset can be found here