scml 0.4.6

ANAC Supply Chain Management League Platform

ANAC Supply Chain Management League Platform

Overview

This repository is the official platform for running ANAC Supply Chain Management Leagues. It will contain a package called scmlXXXX for the competition run in year XXXX. For example scml2019 will contain all files related to the 2019’s version of the competition.

Installation

pip install scml

You can also install the in-development version with:

pip install https://github.com/yasserfarouk/scml/archive/master.zip

Documentation

http://www.yasserm.com/scml/scml2020docs/

Development

To run the all tests run:

tox

Note, to combine the coverage data from all the tox environments run:

Windows	set PYTEST_ADDOPTS=--cov-append tox
Other	PYTEST_ADDOPTS=--cov-append tox

Changelog

0.4.6 (2021.6.15)

• [all tracks] Adding convenience methods to AWIs. closes #49

• [all tracks] reducing production cost range

• [all tracks] casting offers to ints explicitly to avoid bugs in agents offering fractional quantities/unit_prices

• [oneshot] avoiding ultimatum in oneshot (was disabled)

• [oneshot] Add current-inventory to OneshotAWI which will always return zero for compatibility with the other tracks

• [onesht] adding public_* to summary.

• [oneshot] penalty scale was incaccurate

• [std/collusion] Adding satisficer agent

• [std/collusion] adding guarnteed_profit method of world generation

• [std/collusion] better handling of predictions in builtin

• [std/collusion] experimental better decentralizing agent

• [std/collusion] Increasing profit potential

• [speedup] avoid saving negotiations online

0.4.5 (2021.6.14)

• [oneshot] refactoring using before_step in greedy

• [minor] formating update

• [bugfix] production costs were not increasing. closes #38

• [API] Adding before_step() to all agents. If a method called before_step() is defined for an agent, it will be called once every simulated day before any other calls to the agent but after all exogenous contracts and ufun parameters are fixed. Note that step() is called at the end not the beginning of the day.

• [oneshot] limiting exogenous quantities to n lines. This closes #37

• [oneshot] Aspiration negotiator gets more agreements

• [oneshot] allowing agents to skip their turn. Agents can skip their turn now by returning REJECT_OFFER, None

• [oneshot] GreedyOneShotAgent is more rational now

• [bugfix] avoiding an inconsistency in path names for logs

• [oneshot] improved builtin agents (aspiration)

• [tournament] avoiding a possible edge case that would have led to competitor agents appearing as non-competitors

• [tournament] Saving negotiatinos by default in the CLI and utils

• [std/coll] defaulting to narrower worlds

0.4.4 (2021.6.1)

• [oneshot] Matching default parameters of world generation to game description.

0.4.3 (2021.6.1)

• [oneshot] Adding OneshotIndNegotiatorsAgent to use independent negotiators in oneshot

• [std/coll] updating builtin compoenents to be more rational

• [bugfix] failure in distributing products when the number of agents per process becomes large.

• [cli] changes on default competitors in the CLI

• [oneshot] adding the option to disable avoid-ultimatum (and disabling it for now)

• [oneshot] making sure needs are integers in greedy

• [bugfix] negotiator id is not the same as partner id sometimes

• [cli] adding –name to run2021 command to control world name

• [bugfix] negotiator_id and partner_id were not equal

• [eval] ensuring that ageents are run in exactly the same conditions

• [eval] adding zscore, iqr, fraction (old iqr -> iqr_fraction) to truncated mean

• [cli] changing default n. competitors to 2

• [oneshot] adding an option not to count/not count future contracts on bankrruptcy

0.4.2 (2021.5.10)

• [bugfix] Avoiding an error if an agent gave a fractional unit-price

• [bugfix] avoiding a test failure in CI that cannt be reproduced (I hate doing that :-( )

• [bugfix] added current_inventory to 2020’s awi fixes $31

• [cli] Changing default agents for oneshot in cli

• [tournament] adding truncated-mean as an evaluation criterion and making it the default for scml2021

0.4.1 (2021.5.2)

This is an important update. All participants in SCML 2021 should upgrade to this version

• [visualizer] adding run information for the visualizer

• [bugfix] Std agents running in OneShot were able to request selling from the wrong agents.

• [docs] doc update (storage cost -> disposal, deilvery penalty -> shortfall)

• [core] supporting 3.9

• [oneshot] better optimized ufun calculation

• [oneshot] improved ufun calculation. Still not exact.

• [2021] Adding current_balance to all AWIs and using it in oneshot ufun

• [2020] Exporting AWI, Failure from scml2020.world for backward comp.

0.4.0 (2021.3.18)

This is an important update. All participants in SCML 2021 should upgrade to this version

• compatibility with negmas 0.8.0

• [oneshot] bugfix in random negotiator with ami is None

• [scml2020] all market aware agents work now and are parametrized

• [onshot] calculating ufun limits only for normalized ufuns. Agents now MUST

• call find_limit() explicitly on the ufun to calculate limits except for ufuns

• created passing normalized=True in which find_limit() is called to calculate

• best and worst in construction.

• [oneshot][bugfix] my_consumers was wrong issue fix #13

• [docs] documentation update

• [oneshot] adding running_negotiations and unsigned_contracts

• [oneshot] changing breach conditions

• [docs] Update README.rst

0.3.4 (2021.3.8)

• compatibility with negmas 0.7.4

• minor bugfixes

0.3.3 (2021.2.22)

This is an important update. All participants in SCML 2021 should upgrade to this version

• Allowing std/collusion agents to run in OneShot track

• Adding min_utility, max_utility to ufun

• Adding exogenous_*_predictability parameters

• Using these parameters SCML2020/2021/OneShot worlds can be configured so that the exogenous contracts of the same agents at different time-steps are predictable (or not). If predictability is zero then each agent can have any quantity for its exogenous contracts. If predictability is 1.0 then it will have the same quantity at every time-step and if it is somewhere in between, the quantity at different steps will be similar to each other.

• Allowing OneShot agents to run in std track

• balance in one-shot plus bug fixes (lots of them)

• Adding oneshot module for SCML2020-Oneshot track

• Adding disallow_concurrent_negs_with_same_partners If given, avoids concurrent negotiations between the same partners. Avoiding adding assignment number twice to world names

• Adding an upper/lower limit on buying/selling prices

• Adding extra scores for collusion league

• Do not sign clearly bad contracts (Decnetralizing)

• Dropping contracts with time >= current step. These were already being dropped but may not have had a dropped_at value

• Never save videos/logs in tournaments

• avoiding test failure if PyQT was not installed

• Explicitly dropping invalid contracts

• Contracts with 0 price/quantity are nullified

0.3.0 (2020.7.2)

This is an important update. All participants in SCML 2020 should upgrade to this version

• [bugfix] Production cost is not properly discounted. This is an important issue. All simulations were conducted using the same zero production cost for all factories.

• Speeding up tournament tests (smaller worlds)

• consistent naming of non-competitors

• Adding dynamic choice of non-competitors

• Removing random from the set of default agents

• Compatibility with NegMAS 0.6.14

0.2.14 (2020.5.05)

• [docs] documentation and testing update.

• [setup] Making PyQT optional.

• [setup] Requiring negmas 0.6.13.

0.2.13 (2020.4.15)

• [docs] Adding more tutorials

• minor. Maing the controller optional in request_negotiations

• adding score to FactorySimulator to estimate final score

0.2.12 (2020.4.13)

• forcing negmas 0.6.11 or newer

• documentation update

• enabling setting the mechanism parameters in SCML2020World

• bugfix in PredictionBasedTradingStrategy

0.2.11 (2020.3.29)

• bugfix in the CLI when running tournament2019

• bugfix in MeanERPrediction for breached contracts

• making CheapBuyer compatible with the latest negmas version

• doc update

• removing all agent logs in built-in agents to speedup simulations

• changing cli script name back to cli.py. This was done to avoid a weird import error when running configs that use the cli in pycharm

• adding profiling info snapshot to the repository

0.2.10 (2020.3.25)

• minor updates to be compatible with the latest negmas

• documentation update

• avoid exception if gui is not installed

0.2.9 (2020.3.19)

• CI using Github Actions

• consolidating tests outside src directory

• Adding advanced script and upgrading negmas

• removing unnecessary init function from simulator

• showing shorter names in tournament run results

0.2.8 (2020.3.13)

• documentation update (specially the scripts section)

• Adding a –gui option to scml CLI to run it as a simple GUI

• Simplifying the parameters of SCML CLI by keeping only the onese that do not conflict with the default parameters used in the competition

• adding a script call scmladv.py which keep all the detailed parameters used earlied in SCML.

0.2.7 (2020.3.09)

• Documentation update

• Adding trading_strategy_init/step functions.

• Correcting a bug in n_competitors_per_world.

• allowing control of the number of participants per simulation explicitly in scml2020

• [SCML2020] Activating negotiation step quota

• [Doc] Adding a tutorial about logs and stats

• correcting the display in scml run2020

• removing the docs from the package to save space

0.2.6 (2020.2.27)

• [testing] correcting a test to ignore system agents when checking for bankruptcy

• [minor] Reformating using Black

• [bugfix] Resolving a but in the CLI tournament command that prevented it from running with default parameters

0.2.5 (2020.2.27)

• [Documentation] Removing inherited members to make the documentation easier to follow

• [CLI] Improving the display of run2020 command

0.2.4 (2020.2.21)

• [speed] improvement in tournament running

• [bugfix] handling very short simulations

0.2.3 (2020.2.15)

• adding more details to tournament runs

• update to tournament utilities of SCML2020

• doc update and correcting a bug in world generation

• better initialization of production graph depth

• correcting default factory assignments (if any)

• making do_nothing agent really do nothing in scml2020

• removing unnecessary assertion

• correcting world generation using the new width first approach

• correcting world generation using the new width first approach

• documentation update

• adding no_logs option to SCMLWorld2019 and SCMLWorld2020

• changing default logging location for SCML2019 and SCML2020 to ~/negmas/logs/tournament

• changing the way worlds are generated in SCML2020 to minimize the number of agents per level allowing the depth to increase

• removing built docs from the repository

• modification to .gitignore

• updating .gitignore

0.2.2 (2020.1.31)

• adding components

• adding second tutorial

0.2.1 (2020.1.23)

• better tutorial

• better strategies

0.2.0 (2020.1.8)

• new interface for singing and callbacks

• new interface for exogenous contracts

• improved decentralizing strategy

0.1.5 (2019.12.11)

• correcting tournament implementation for SCML2020

• updates to SCML2019 agents to be compatible with newer versions of negmas

0.1.3 (2019-12-08)

• adding run2020 to scml commands (see the command line tool’s documentation)

• Now tournaments run for SCML 2020 configuration

0.1.2 (2019-12-01)

• Adding SCML 2020 simulation.

0.1.1 (2019-11-25)

• Adding all agents from SCML 2019 competition to the scml2019 package.

• Adding first draft of SCML 2020 implementation.

0.1.0 (2019-11-20)

• First release on PyPI.