This project provides a command line interface to query the WattDepot server that gathers energy usage data for the Hale Aloha dorms at the University of Hawaii--Manoa.

The commands supported by the system are:

current-power [tower | lounge]

This command displays the current power in kW for the requested tower or lounge.

daily-energy [tower | lounge] [date]

This command displays the energy in kWh used by the requested tower or lounge for the specified date.

energy-since [tower | lounge] [date]

This command displays the energy used from date specified to now.

rank-towers [start date] [end date]

This command displays a list in sorted order from least to most energy consumed between the start and end dates specified.

set-baseline [tower | lounge] [date]

This command defines date as the "baseline" day for a tower or lounge, and obtains and saves the amount of energy used during each of the 24 hours of that day for the given tower or lounge. date is an optional argument in YYYY-MM-DD format and defaults to yesterday.

monitor-power [tower | lounge] [interval]

This command prints out a timestamp and the current power for a tower or lounge every interval seconds, where interval is an optional integer greater than 0 and defaults to 10 seconds, and is interrupted by entering any character (such as a carriage return).

monitor-goal [tower | lounge] goal interval

This command prints out a timestamp, the current power being consumed by the a tower or lounge, and whether or not the lounge is meeting its power conservation goal, where goal is an integer between 1 and 99 that specifies the desired percentage reduction from the baseline for this tower or lounge during this hour of the day, and interval is an integer greater than 0. This command is also interrupted by entering any character (such as a carriage return).

quit

This command terminates the program.

help

This command displays useful help text for the program.

For more information

Please see the Wiki, particularly the UserGuide.