Skip to content

Commit

Permalink
V2.6.2
Browse files Browse the repository at this point in the history
  • Loading branch information
himeinhardt committed Oct 2, 2021
1 parent 1a177ae commit 3727338
Show file tree
Hide file tree
Showing 7 changed files with 1,950 additions and 1,229 deletions.
15 changes: 15 additions & 0 deletions ChangeLog
Original file line number Diff line number Diff line change
Expand Up @@ -227,3 +227,18 @@
Version 2.6.1

Code revision and optimization. The (anti-)pre-kernel computation is now faster up to a factor 3 in serial as well as in parallel.

Version 2.6.2

Adding functions:
- AlmostConvexQ[] to check if the game is almost convex.
- AlmostConcaveQ[] to check if the game is almost concave.
- ADMCGameQ[] to check the property if the game satisfies almost diminishing marginal contributions.
- AIMCGameQ[] to check the property if the game satisfies almost increasing marginal contributions.
- kConvexity[] to check if the game is k-convex.
- EANSCValue[] to compute the Equal Allocation of Non-Separable Contribution/Cost value.

Revised the functions:
ConvexQ[], ConcaveQ[], Nuc1convex[].

Minor Bug fixes and code revision.
15 changes: 15 additions & 0 deletions ChangeLog.md
Original file line number Diff line number Diff line change
Expand Up @@ -247,3 +247,18 @@
1. Revision:

* Code revision and optimization. The (anti-)pre-kernel computation is now faster up to a factor 3 in serial as well as in parallel.

### Version 2.6.2

Adding functions:
* AlmostConvexQ[] to check if the game is almost convex.
* AlmostConcaveQ[] to check if the game is almost concave.
* ADMCGameQ[] to check the property if the game satisfies almost diminishing marginal contributions.
* AIMCGameQ[] to check the property if the game satisfies almost increasing marginal contributions.
* kConvexity[] to check if the game is k-convex.
* EANSCValue[] to compute the Equal Allocation of Non-Separable Contribution/Cost value.

Revised the functions:
ConvexQ[], ConcaveQ[], Nuc1convex[].

Minor Bug fixes and code revision.
2 changes: 1 addition & 1 deletion PacletInfo.m
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Paclet[
Name -> "TUG",
Version -> "2.6.1",
Version -> "2.6.2",
MathematicaVersion -> "10+",
Description -> "A Mathematica Package for Cooperative Game Theory",
Creator -> "Holger Ingmar Meinhardt <[email protected]>",
Expand Down
54 changes: 32 additions & 22 deletions README
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Mathematica Package: TuGames Version 2.5.4
Mathematica Package: TuGames Version 3.0.0
==============================
Contents:
1. Introduction
Expand All @@ -25,10 +25,15 @@ Moreover, it verifies if the game is convex, average-convex or superadditive
just to mention some interesting game properties. It can be used in serial
as well as in parallel mode, and in conjunction with MATLink to build up a Matlab
connection to invoke the toolbox MatTuGames. This package is exclusively
dedicated to Mathematica version 8.x and higher. In this respect, the graphical
features should run on all platforms. As a highlight, a fast algorithm
to seek for a pre-kernel element is implemented in the updated package. This
algorithm is described in the book
dedicated to Mathematica version 12.x and higher, because `TUG-3.0.0` is the first
version that is transcribed to the new collection of algorithms for solving convex problems
introduced in version 12. For Mathematica versions smaller than 12.0 one should use `TUG-2.6.2`.
This version remains compatible with the most recent Mathematica version as long as
ConstrainedMax/ConstrainedMin and LinearProgramming/DualLinearProgramming are supported by Wolfram Research,
otherwise one has to to switch to `TUG-3.0.0` or later. In this respect, the graphical
features should run on all platforms. As a highlight, a fast algorithm to seek for a
pre-kernel element is implemented in the updated package. This algorithm is described
in the book

The Pre-Kernel as a Tractable Solution for Cooperative Games
An Exercise in Algorithmic Game Theory
Expand Down Expand Up @@ -110,10 +115,10 @@ the command

In[1]:= PacletInformation["TUG"]

Out[1]= {Name -> TUG, Version -> 2.6.1, BuildNumber -> , Qualifier -> , WolframVersion -> 10+,
Out[1]= {Name -> TUG, Version -> 3.0.0, BuildNumber -> , Qualifier -> , WolframVersion -> 12+,
SystemID -> All, Description -> A Mathematica Package for Cooperative Game Theory,
Category -> , Creator -> Holger Ingmar Meinhardt <[email protected]>,
Publisher -> , Support -> , Internal -> False, Location -> /home/kit/xxx/xxxx/.Mathematica/Paclets/Repository/TUG-2.6.1
Publisher -> , Support -> , Internal -> False, Location -> /home/kit/xxx/xxxx/.Mathematica/Paclets/Repository/TUG-3.0.0
Context -> {TUG`coop`, TUG`vertex`, TUG`}, Enabled -> True, Loading -> Manual}


Expand All @@ -123,7 +128,7 @@ To get the same information and beyond that under Mathematica version 12.1, it i
In[1]:= PacletObject["TUG"][All]


Out[1]= {"Name" -> "TUG", "Version" -> "2.6.1", "WolframVersion" -> "10+",
Out[1]= {"Name" -> "TUG", "Version" -> "3.0.0", "WolframVersion" -> "12+",
"Qualifier" -> "", "SystemID" -> All, "Description" -> "A Mathematica Package for Cooperative Game Theory",
"Category" -> Missing["NotAvailable"], "Keywords" -> Missing["NotAvailable"],
"UUID" -> Missing["NotAvailable"],
Expand All @@ -133,7 +138,7 @@ Out[1]= {"Name" -> "TUG", "Version" -> "2.6.1", "WolframVersion" -> "10+",
"Internal" -> False,
"Context" -> {"TUG`coop`", "TUG`vertex`", "TUG`"},
"Loading" -> Manual, "AutoUpdating" -> False, "Enabled" -> True,
"Location" -> "/home/kit/xxx/xxxx/.Mathematica/Paclets/Repository/TUG-2.6.1"}
"Location" -> "/home/kit/xxx/xxxx/.Mathematica/Paclets/Repository/TUG-3.0.0"}

or alternatively

Expand Down Expand Up @@ -168,27 +173,32 @@ version should not be smaller than 10. For Mathematica versions smaller than Ver
installation is requested. In that case one has to follow the guidelines related to the associated
operating system that can be found from the Mathematica documentation.

The most simplest method is to install the `Paclet` directly from GitHub under Mathematica V11.3 or later
Notice that `TUG-2.6.2` is the lasted version that is compatible with Mathematica versions smaller than 12.0,
and will remain compatible with the most recent Mathematica version as long as ConstrainedMax/ConstrainedMin and
LinearProgramming/DualLinearProgramming are supported by Wolfram Research, otherwise one has to update
to `TUG-3.0.0` or later.

The most simplest method is to install the `Paclet` directly from GitHub under Mathematica V12.0 or later
while executing

```

ResourceFunction["GitHubInstall"]["himeinhardt", "TuGames"]
```

For smaller versions than 11.3 start Mathematica, open a notebook, and execute therein

For smaller versions than 12.0 start Mathematica, open a notebook, and execute therein


PacletInstall["/full/Path/to/TUG-2.6.1.paclet"]
PacletInstall["/full/Path/to/TUG-2.6.2.paclet"]

that should return the value
to install TUG-2.6.2 the last version compatible with a Mathematica version smaller than 12.0. That should return the value

Paclet[TUG, 2.6.1, <>]
Paclet[TUG, 2.6.2, <>]

to indicate a successful installation. Notice that

"/full/Path/to/TUG-2.6.1.paclet"
"/full/Path/to/TUG-2.6.2.paclet"

indicates the directory where the TUG-2.6.1.paclet is located at your hard-disk.
indicates the directory where the TUG-2.6.2.paclet is located at your hard-disk.

Alternatively, one can directly install the package from GitHub with the help of the Mathematica-Tools from

Expand Down Expand Up @@ -251,10 +261,10 @@ In[2]:= Needs["TUG`"]
===================================================
Loading Package 'TuGames' for Unix
===================================================
TuGames V2.6.1 by Holger I. Meinhardt
Release Date: 05.05.2020
Program runs under Mathematica Version 8.0 or later
Version 8.x or higher is recommended
TuGames V3.0.0 by Holger I. Meinhardt
Release Date: 01.10.2021
Program runs under Mathematica Version 12.0 or later
Version 12.x or higher is recommended
===================================================
===================================================
Package 'TuGames' loaded
Expand Down
54 changes: 33 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
[![GitHub (pre-)release](https://img.shields.io/github/release/himeinhardt/TuGames/all.svg)](https://github.com/himeinhardt/TuGames/releases)
[![Mathematica 12.0 - 12.3.1](https://img.shields.io/badge/Mathematica-12.0_--_12.3.1-brightgreen.svg)](#compatibility)
[![license MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/himeinhardt/TuGames/blob/master/LICENSE.md)

# *Mathematica* Package: *TuGames* Version 2.6.1
# *Mathematica* Package: *TuGames* Version 3.0.0

```
Contents:
Expand Down Expand Up @@ -30,10 +32,15 @@ Moreover, it verifies if the game is convex, average-convex or superadditive
just to mention some interesting game properties. It can be used in serial
as well as in parallel mode, and in conjunction with *MATLink* to build up a *Matlab*
connection to invoke the toolbox *MatTuGames*. This package is exclusively
dedicated to Mathematica version 8.x and higher. In this respect, the graphical
features should run on all platforms. As a highlight, a fast algorithm
to seek for a pre-kernel element is implemented in the updated package. This
algorithm is described in the book
dedicated to Mathematica version 12.x and higher, because `TUG-3.0.0` is the first
version that is transcribed to the new collection of algorithms for solving convex problems
introduced in version 12. For Mathematica versions smaller than 12.0 one should use `TUG-2.6.2`.
This version remains compatible with the most recent Mathematica version as long as
ConstrainedMax/ConstrainedMin and LinearProgramming/DualLinearProgramming are supported by Wolfram Research,
otherwise one has to to switch to `TUG-3.0.0` or later. In this respect, the graphical
features should run on all platforms. As a highlight, a fast algorithm to seek for a
pre-kernel element is implemented in the updated package. This algorithm is described
in the book

```
The Pre-Kernel as a Tractable Solution for Cooperative Games
Expand Down Expand Up @@ -124,10 +131,10 @@ the command
```
In[1]:= PacletInformation["TUG"]
Out[1]= {Name -> TUG, Version -> 2.6.1, BuildNumber -> , Qualifier -> , WolframVersion -> 10+,
Out[1]= {Name -> TUG, Version -> 3.0.0, BuildNumber -> , Qualifier -> , WolframVersion -> 12+,
SystemID -> All, Description -> A Mathematica Package for Cooperative Game Theory,
Category -> , Creator -> Holger Ingmar Meinhardt <[email protected]>,
Publisher -> , Support -> , Internal -> False, Location -> /home/kit/xxx/xxxx/.Mathematica/Paclets/Repository/TUG-2.6.1
Publisher -> , Support -> , Internal -> False, Location -> /home/kit/xxx/xxxx/.Mathematica/Paclets/Repository/TUG-3.0.0
Context -> {TUG`coop`, TUG`vertex`, TUG`}, Enabled -> True, Loading -> Manual}
```

Expand All @@ -137,7 +144,7 @@ To get the same information and beyond that under *Mathematica* version 12.1, it
In[1]:= PacletObject["TUG"][All]
```
```
Out[1]= {"Name" -> "TUG", "Version" -> "2.6.1", "WolframVersion" -> "10+",
Out[1]= {"Name" -> "TUG", "Version" -> "3.0.0", "WolframVersion" -> "12+",
"Qualifier" -> "", "SystemID" -> All, "Description" -> "A Mathematica Package for Cooperative Game Theory",
"Category" -> Missing["NotAvailable"], "Keywords" -> Missing["NotAvailable"],
"UUID" -> Missing["NotAvailable"],
Expand All @@ -147,7 +154,7 @@ Out[1]= {"Name" -> "TUG", "Version" -> "2.6.1", "WolframVersion" -> "10+",
"Internal" -> False,
"Context" -> {"TUG`coop`", "TUG`vertex`", "TUG`"},
"Loading" -> Manual, "AutoUpdating" -> False, "Enabled" -> True,
"Location" -> "/home/kit/xxx/xxxx/.Mathematica/Paclets/Repository/TUG-2.6.1"}
"Location" -> "/home/kit/xxx/xxxx/.Mathematica/Paclets/Repository/TUG-3.0.0"}
```
or alternatively

Expand Down Expand Up @@ -187,32 +194,37 @@ version should not be smaller than 10. For Mathematica versions smaller than Ver
installation is requested. In that case one has to follow the guidelines related to the associated
operating system that can be found from the Mathematica documentation.

The most simplest method is to install the `Paclet` directly from GitHub under Mathematica V11.3 or later

Notice that `TUG-2.6.2` is the lasted version that is compatible with Mathematica versions smaller than 12.0,
and will remain compatible with the most recent Mathematica version as long as ConstrainedMax/ConstrainedMin and
LinearProgramming/DualLinearProgramming are supported by Wolfram Research, otherwise one has to update
to `TUG-3.0.0` or later.

The most simplest method is to install the `Paclet` directly from GitHub under Mathematica V12.0 or later
while executing

```
ResourceFunction["GitHubInstall"]["himeinhardt", "TuGames"]
```

For smaller versions than 11.3 start Mathematica, open a notebook, and execute therein
For smaller versions than 12.0 start Mathematica, open a notebook, and execute therein

```
PacletInstall["/full/Path/to/TUG-2.6.1.paclet"]
PacletInstall["/full/Path/to/TUG-2.6.2.paclet"]
```

that should return the value
to install TUG-2.6.2 the last version compatible with a Mathematica version smaller than 12.0. That should return the value

```
Paclet[TUG, 2.6.1, <>]
Paclet[TUG, 2.6.2, <>]
```

to indicate a successful installation. Notice that

```
"/full/Path/to/TUG-2.6.1.paclet"
"/full/Path/to/TUG-2.6.2.paclet"
```

indicates the directory where the `TUG-2.6.1.paclet` is located at your hard-disk.
indicates the directory where the `TUG-2.6.2.paclet` is located at your hard-disk.

Alternatively, one can directly install the package from GitHub with the help of the *Mathematica-Tools* from

Expand Down Expand Up @@ -280,10 +292,10 @@ In[2]:= Needs["TUG`"]
===================================================
Loading Package 'TuGames' for Unix
===================================================
TuGames V2.6.1 by Holger I. Meinhardt
Release Date: 05.05.2020
Program runs under Mathematica Version 8.0 or later
Version 8.x or higher is recommended
TuGames V3.0.0 by Holger I. Meinhardt
Release Date: 01.10.2021
Program runs under Mathematica Version 12.0 or later
Version 12.x or higher is recommended
===================================================
===================================================
Package 'TuGames' loaded
Expand Down
Loading

0 comments on commit 3727338

Please sign in to comment.