Provides a simple command line interface for obtaining information from a WattDepot service.

The Command Specification page provides documentation on the acceptable commands.

Here is a sample session that gives the flavor of the system. Note that the sources all return simulated data for the Oahu power grid.

[~] java -jar wattdepot-cli.jar http://server.wattdepot.org:8182/wattdepot/
Connecting to WattDepot server.
Connected to http://server.wattdepot.org:8182/wattdepot/
Starting command interface.
>help
help
  This message
quit
  Exits the system
carboncontent {source} {timestamp} sampling-interval {interval}
  Computes the carbon content of the source.
carbonstats {source} from {start} to {end}
  Finds the max/min/average carbon content for a source over a time period.
chart power [generated|consumed] {source} {startday} {endday} sampling-interval {minutes} file {file}
  Writes out an html file that will display a chart illustrating the carbon or energy for the source over the interval.
dailysensordata {source} day {day}
  Prints a table listing all of the sensor data instances for the specified day.
energystats generated {source} from {start} to {end} {hourly|daily}
  Find the max/min/average energy consumption by a source between the given dates.fueltypes {source}
  Prints information about sources generating power using different fuel types.
power [generated|consumed] {source} timestamp {timestamp}
  Prints the power generated by the source at the given timestamp.
powerstats [generated|consumed] {source} day {day} sampling-interval {minutes} statistic {max|min|average}
  Returns the maximum, minimum, or average power generated by the source for the day.
sensordata {source} timestamp {timestamp}
  Prints information about a single sensor data instance.
sources
  Prints a table summarizing the public sources in the system, one per line.
summary {source}
  Prints information about a single source.
total [carbon|energy] generated {source} day {day} sampling-interval {minutes}
  Returns the total amount of carbon (or energy) emitted by this source for the given day.
totalpower {source} {timestamp} fueltype {fueltype}
  Prints information about the power generated by a source given a fueltype.

>sources
 Name                 Parent               Description                                        
 SIM_AES              SIM_IPP              AES Hawaii is an independent power producer on Oahu's grid that uses coal as its fuel. 
 SIM_HONOLULU         SIM_OAHU_GRID        Virtual resource for all Honolulu power plants.    
 SIM_HONOLULU_8       SIM_HONOLULU         Honolulu 8 is a HECO plant on Oahu's grid that uses LSFO as its fuel. 
 SIM_HONOLULU_9       SIM_HONOLULU         Honolulu 9 is a HECO plant on Oahu's grid that uses LSFO as its fuel. 
 SIM_HPOWER           SIM_IPP              HPOWER is an independent power producer on Oahu's grid that uses municipal waste as its fuel. 
 SIM_IPP              SIM_OAHU_GRID        Virtual resource for all independent power producers (non-HECO). 
 SIM_KAHE             SIM_OAHU_GRID        Virtual resource for all Kahe power plants.        
 SIM_KAHE_1           SIM_KAHE             Kahe 1 is a HECO plant on Oahu's grid that uses LSFO as its fuel. 
 SIM_KAHE_2           SIM_KAHE             Kahe 2 is a HECO plant on Oahu's grid that uses LSFO as its fuel. 
 SIM_KAHE_3           SIM_KAHE             Kahe 3 is a HECO plant on Oahu's grid that uses LSFO as its fuel. 
 SIM_KAHE_4           SIM_KAHE             Kahe 4 is a HECO plant on Oahu's grid that uses LSFO as its fuel. 
 SIM_KAHE_5           SIM_KAHE             Kahe 5 is a HECO plant on Oahu's grid that uses LSFO as its fuel. 
 SIM_KAHE_6           SIM_KAHE             Kahe 6 is a HECO plant on Oahu's grid that uses LSFO as its fuel. 
 SIM_KAHE_7           SIM_KAHE             Kahe 7 is a HECO plant on Oahu's grid that uses LSFO as its fuel. 
 SIM_KALAELOA         SIM_IPP              Kalaeloa is an independent power producer on Oahu's grid that uses LSFO as its fuel. 
 SIM_OAHU_GRID                             Virtual resource for all Oahu power plants.        
 SIM_WAIAU            SIM_WAIAU            Virtual resource for all Waiau power plants.       
 SIM_WAIAU_10         SIM_WAIAU            Waiau 10 is a HECO plant on Oahu's grid that uses diesel as its fuel. 
 SIM_WAIAU_5          SIM_WAIAU            Waiau 5 is a HECO plant on Oahu's grid that uses LSFO as its fuel. 
 SIM_WAIAU_6          SIM_WAIAU            Waiau 6 is a HECO plant on Oahu's grid that uses LSFO as its fuel. 
 SIM_WAIAU_7          SIM_WAIAU            Waiau 7 is a HECO plant on Oahu's grid that uses LSFO as its fuel. 
 SIM_WAIAU_8          SIM_WAIAU            Waiau 8 is a HECO plant on Oahu's grid that uses LSFO as its fuel. 
 SIM_WAIAU_9          SIM_WAIAU            Waiau 9 is a HECO plant on Oahu's grid that uses diesel as its fuel. 

>summary SIM_OAHU_GRID
 SubSources: SIM_KAHE ,SIM_WAIAU ,SIM_HONOLULU ,SIM_IPP 
 Description: Virtual resource for all Oahu power plants. 
 Owner: oscar@wattdepot.org 
 Location: To be looked up later 
 Coordinates: 0,0,0 
 Properties:  
 Earliest data: 2009-10-25T00:00:00.000-10:00 
 Latest data: 2009-12-31T23:45:00.000-10:00 
 Total data points: 117504 

>total energy generated SIM_OAHU_GRID day 2009-11-01 sampling-interval 60
14089.0 MWh
>quit
Exiting Wattdepot CLI
[~]->