scml
0.4.7
Overview
Overview
Installation
Documentation
Development
Installation
Usage
Tutorials
What is SCM and SCML?
A (not very) brief introduction to NegMAS
A brief introduction to SCM
The Oneshot game (OneShot)
The Full game (Standard/Collusion Tracks)
Run a session of the SCML world (2021)
Running a tournament
Running a One-Shot tournament
Developing an agent for SCML2021 (OneShot)
Building your own agent
Your AWI
Your ufun
Your callbacks
OneShotAgent
Simple OneShotAgent
A better greedy agent
Thinking about other negotiations
Learning over time
More General Simple Agent (advanced)
OneShotSyncAgent
SyncAgent
SingleAgreementOneShotAgent
Using Independent Negotiators
Using A Negotiator from the Genius Platform
Comparing all agents
Running SCML2020 agents (advanced)
Developing an agent for SCML2021 (Std/Collusion)
Do Nothing Agent
Your AWI
Agent Anatomy
Strategies
Production Strategy
Trading Strategy
Negotiation Control Strategy
Creating our own negotiation control strategy
Changing the negotiation strategy
Overriding an agent directly
An agent from scratch
A competition
Running OneShot agents (advanced)
Running Controlled Experiments
Controlling agent allocation to factories
Controlling construction paramteres
Controlling other aspects of the simulation
Controlling Profiles
Controlling exogenous contracts
Standard SCML2020World
SCMLOneshot World
Logging and Statistics
Types of Logs
Primer on logging in negmas
Controlling logging
Getting infromation about a simulation
World Information
params.json
info.json
stats.csv and stats.json
Contracts and Negotiations
negotiations.csv
contracts.csv
breaches.csv
Ideas for developing your agent (Standard)
Trading Strategy
IDEA 1: Improve trade prediction
IDEA 2: Improve execution rate prediction
IDEA3: Improve the logic of the trading strategy
Negotiation Manager
IDEA 4: Improve the negotiation manager
IDEA 5 Improve signing strategy
Negotiation Algorithm
IDEA 6: Improve concurrent negotiation control
IDEA 7: Improve sequential negotiation control
IDEA 8: Improve the utility functions used
Production Strategy
IDEA 9: Base production decisions on trading prices (as well as contracts).
Ideas for developing you agent (OneShot)
IDEA 10: Learn the acceptance strategy of your partners
IDEA 11: Predict future market conditions
Final Remarks
FAQ
How can I access a data file in my package?
Can my agent pass data to my other agents between worlds?
Can my agent read data from the HDD outside my agent’s folder?
Can my agent write data to the HDD during the simulation?
Can I print to the screen to debug my agent?
Can I write arbitrary code in my module besides the agent class definition?
I ran a simulation using “scml run2020” command. Where are my log files?
I implement my agent using multiple files. How should I import them?
How can I run simulations with the same parameters as the actual competition (e.g. for training my agent)
SCML2020/2021
scml.scml2020 Package
Functions
is_system_agent
Classes
FactoryState
FinancialReport
FactoryProfile
Failure
ExogenousContract
RandomAgent
DoNothingAgent
IndependentNegotiationsAgent
MarketAwareIndependentNegotiationsAgent
BuyCheapSellExpensiveAgent
MarketAwareBuyCheapSellExpensiveAgent
DecentralizingAgent
IndDecentralizingAgent
DecentralizingAgentWithLogging
MarketAwareDecentralizingAgent
MarketAwareIndDecentralizingAgent
ReactiveAgent
MarketAwareReactiveAgent
MovingRangeAgent
MarketAwareMovingRangeAgent
SatisficerAgent
SCML2020World
SCML2021World
Failure
AWI
Simulation
ProductionStrategy
SupplyDrivenProductionStrategy
DemandDrivenProductionStrategy
TradeDrivenProductionStrategy
TradePredictionStrategy
FixedTradePredictionStrategy
ExecutionRatePredictionStrategy
FixedERPStrategy
MeanERPStrategy
MarketAwareTradePredictionStrategy
SignAll
SignAllPossible
KeepOnlyGoodPrices
TradingStrategy
ReactiveTradingStrategy
PredictionBasedTradingStrategy
MarketAwarePredictionBasedTradingStrategy
NegotiationManager
StepNegotiationManager
IndependentNegotiationsManager
MovingRangeNegotiationManager
Factory
AWI
SCML2020Agent
OneShotAdapter
Class Inheritance Diagram
SCML2020-OneShot
scml.oneshot Package
Functions
builtin_agent_types
Classes
OneShotState
OneShotExogenousContract
OneShotProfile
SCML2020OneShotWorld
OneShotUFun
UFunLimit
OneShotAgent
OneShotSyncAgent
OneShotSingleAgreementAgent
OneShotIndNegotiatorsAgent
EndingNegotiator
RandomOneShotAgent
SyncRandomOneShotAgent
SingleAgreementRandomAgent
SingleAgreementAspirationAgent
GreedyOneShotAgent
GreedySyncAgent
GreedySingleAgreementAgent
OneshotDoNothingAgent
OneShotAWI
Class Inheritance Diagram
SCML2019
scml.scml2019 Package
Simulation steps:
Remarks about re-negotiation on breaches:
Remarks about timing:
Remarks about ANAC 2019 SCML League:
Functions
transaction
temporary_transaction
anac2019_world
anac2019_tournament
anac2019_collusion
anac2019_std
balance_calculator
anac2019_sabotage
pos_gauss
_safe_max
zero_runs
Classes
Product
Process
InputOutput
RunningCommandInfo
ManufacturingProfile
ManufacturingProfileCompiled
ProductManufacturingInfo
FactoryStatusUpdate
Job
ProductionNeed
MissingInput
ProductionReport
ProductionFailure
FinancialReport
SCMLAgreement
SCMLAction
CFP
Loan
InsurancePolicy
Factory
FactoryState
SCMLAWI
FactoryManager
DoNothingFactoryManager
GreedyFactoryManager
JavaFactoryManager
JavaDoNothingFactoryManager
JavaGreedyFactoryManager
JavaDummyMiddleMan
DefaultBank
Bank
DefaultInsuranceCompany
InsuranceCompany
SCML2019Agent
FactorySimulator
SlowFactorySimulator
FastFactorySimulator
DefaultGreedyManager
ScheduleInfo
Scheduler
GreedyScheduler
SCML2019World
Factory
Consumer
ConsumptionProfile
JustInTimeConsumer
Miner
MiningProfile
ReactiveMiner
Class Inheritance Diagram
Command Line Scripts
Running SCML2020 Tournaments
Running SCML2019 Tournaments
Running an SCML2020 world (scml run2020)
Running an SCML2019 world (scml run2019)
Reference
scml
Contributing
Bug reports
Documentation improvements
Feature requests and feedback
Development
Pull Request Guidelines
Tips
Authors
Changelog
0.4.7 (2021.7.15)
0.4.6 (2021.6.15)
0.4.5 (2021.6.14)
0.4.4 (2021.6.1)
0.4.3 (2021.6.1)
0.4.2 (2021.5.10)
0.4.1 (2021.5.2)
0.4.0 (2021.3.18)
0.3.4 (2021.3.8)
0.3.3 (2021.2.22)
0.3.0 (2020.7.2)
0.2.14 (2020.5.05)
0.2.13 (2020.4.15)
0.2.12 (2020.4.13)
0.2.11 (2020.3.29)
0.2.10 (2020.3.25)
0.2.9 (2020.3.19)
0.2.8 (2020.3.13)
0.2.7 (2020.3.09)
0.2.6 (2020.2.27)
0.2.5 (2020.2.27)
0.2.4 (2020.2.21)
0.2.3 (2020.2.15)
0.2.2 (2020.1.31)
0.2.1 (2020.1.23)
0.2.0 (2020.1.8)
0.1.5 (2019.12.11)
0.1.3 (2019-12-08)
0.1.2 (2019-12-01)
0.1.1 (2019-11-25)
0.1.0 (2019-11-20)
scml
»
Usage
View page source
Usage
¶
To use SCML in a project:
import
scml