Documentation for the PowerMatcher. For a better readable format of the documentation see https://fan-ci.sensorlab.tno.nl/builds/powermatcher-documentation/
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
advanced
img-architecture
img-faq
img-setting-up-your-ide
APIandCOREPM.png
Advanced Topics.md
AdvancedPMCluster.md
Aggregated.png
AggregatedBid1.png
Aggregation.md
Architecture-PowerMatcher.md
ArrayBid.png
AuctioneerEquilibrium.png
BaseBid.png
BidNumbers.md
Bids.md
Branching.md
CSVLogger.md
CSV_create.png
CSV_output.png
ClusterVisualizer.md
CodingConventions.md
ContinuousIntegration.md
Contributing.md
CreateADeviceAgent.md
DataObjects.md
DeviceAgentBid.png
DeviceAgentControl1.png
DeviceAgentEFI.png
EFPi_PM.md
ElasticSearchLogger.md
Equilibrium.md
Equilibrium1.png
Events-Scheduling.md
ExtensionComponents.md
FAQ.md
FlexiblePowerContext.md
FreezerBid.png
FreezerHeatUp.png
Inheritence3.png
KLEStack.md
Lifecycle.md
LoggingFramework.md
Messages.md
NewSetPoint.png
NoPeakshavingBid1.png
OSGi.md
Objective.md
Osgi_framework.png
PMbaseStructure.png
PeakShaving.md
PeakshavingBid1.png
PointBid.png
PowerMatcher-API.md
PowerMatcher-Core.md
PowerMatcher-Monitoring.md
PowerMatcher-Security-Guidelines.md
README.md
ReleaseNotes.md
RemoteCommunication.md
Runtime.md
SUMMARY.md
Session.md
SettingUpTheIDE.md
SimplePMCluster.md
Tests.md
Tutorials.md
UniquenessAgents.png
VPP.png
Visualizer.md
Websockets.md
_Footer.md
_Sidebar.md
agentendpoints3.png
agentrole_matcherrole.png
auctioneer_config.png
bid_price_through_tree_PM.png
book.json
concentrator_config.png
configuration-csvlogger.png
cooldown.png
eclipse_example_bndrun.png
endpoints.png
felix_bundles.png
felix_config_mgr.png
forecast.png
import_xml.png
logstash-powermatcher.conf
npm-debug.log
objectiveEvent.png
objective_agent.png
objective_cluster.png
oscillatie2.png
oscillation_example2.png
pm-monitoring.jpg
publishPrice.png
pvpanel2_config.png
pvpanel_config.png
sessionManager.png
session_manager2_config.png
session_manager_config.png
sessionmanagerConnections.png
sessionsPM.png
simple_clusters.png
visualisation_add_windTurbine.png
visualisation_cluster_auctioneer.png
visualisation_cluster_extra.png
visualisation_cluster_full.png
visualisation_cluster_full_edit.png
visualisation_cluster_highlight_endpoint.png
visualisation_cluster_highlight_single.png
visualisation_config.png
visualisation_felix_menu.png
visualisation_new_auctioneer.png
visualisation_node_delete.png
visualisation_node_edit.png
visualisation_start.png
websockets.jpg
whitelist.md
whitelist.png
whitelistagent.png
whitelistagentremote.png
workspace.png

README.md

Welcome

For those interested in general information on the Why and How of PowerMatcher please dive into the PowerMatcherSuite website. PowerMatcher documentation related questions or improvement suggestions? report them here.

The PowerMatcher is a smart grid coordination mechanism. It balances distributed energy resources (DER) and (flexible) loads. It can also be herded among Demand Response systems, but with a radical new vision. A vision that we call Smart Transactive Energy.

#The PowerMatcher concept

The PowerMatcher concept is based on the micro-economic principle of demand and supply. Supply and demand is one of the most fundamental concepts of economics and it is the backbone of a market economy.

The relationship between demand and supply is the underlying force behind the allocation of resources. In market economy theory, demand and supply theory will allocate resources in the most efficient way possible.
When supply and demand are equal (i.e. when the supply function and demand function intersect) the economy is said to be at equilibrium.

The same mechanism is used in the PowerMatcher. The PowerMatcher core application provides the market mechanism for the determination of the market equilibrium, while the devices work as actors for demand and/or supply. Each device, whether this is a washing maschine, windmill, or industrial turbine can express his willingness to consume or produce energy in the form of a bid (a demand or supply relationship). All bids come together in the market mechanism of the PowerMatcher and result in an equilibrium price.

A Van Gogh painting

Try to picture a normal auction where a potential buyer would bid on an object e.g. someone bidding on a Van Gogh painting. This process would iterate a couple of times because the buyer does not want to 'show all his cards' in order to get the cheapest price possible.

A PowerMatcher "auction" does NOT!! work that way...

In the PowerMatcher protocol a Bid describes the device's entire demand or supply relationship. The device agent lays out all his cards on the table on every bidding occasion and updates his demand or supply relationship based on the state of machine (e.g. low battery wants to charge). As a result the Auctioneer has all the demand and supply information in the market and requires zero iterations to determine the market equilibrium.

EF-Pi integration

If you want to make your life easier; after studying the concepts of the PowerMatcher it is advised to look into EF-Pi. EF-Pi will greatly reduce you effort in connecting devices.