Prepare release 16.1.0a1.

.github/workflows/tools.yml

@@ -41,7 +41,10 @@ jobs:
       - run: ./configure
       - run: make
       - run: sudo make install
-      - run: make osx-bundle
+      - run: make osx-dmg
+      - uses: actions/upload-artifact@v3
+        with:
+          path: "*.dmg"
 
   windows:
     runs-on: windows-latest

ChangeLog

@@ -1,17 +1,26 @@
-## [16.1.0] - Unreleased
+# Changelog
 
-### General
+## [16.1.0a1] - 2023-09-14
+
+### Changed
+- Cython 3.0 is now used for pygambit.
+- Documentation of the pygambit API has been moved into docstrings.
+- Chance action probabilities are now enforced to sum to exactly one at an information
+  set.  This is accomplished by changing the API to set probabilities for all actions
+  simultaneously; it is no longer possible to assign an action probability individually.
+
+### Added
 - Documented support in Python for estimating quantal response equilibria using
   either fixed-point or empirical payoff methods
 
-## [16.0.3] - Unreleased
-
 ### Fixed
+- Corrected reference counting for C++ Game objects which could result in objects
+  never being deallocated (see #331)
+- Corrected Lyapunov function minimisation returning critical points that are
+  not global minima (i.e. not equilibria) (#329)
 - Corrected a regression in accessing contingencies of a game in Python.
-- Removed use of explcit StopIteration (a holdover from Python 2.x support).	
+- Removed use of explicit StopIteration (a holdover from Python 2.x support).
 
-### General
-- C++11 features are now actively used.
 
 
 ## [16.0.2] - 2022-01-28

INSTALL.md

@@ -126,12 +126,11 @@ a wxWidgets installation.
 ### pygambit Python extension
 
 Gambit is available as a Python extension module, called `pygambit`.
-Python versions 3.7 through 3.10 inclusive are supported.
 `pygambit` is available via PyPi and `pip`.
 
-If you wish to compile the extension module on your own, then you can
+If you wish to compile the extension module on your own, then you can,
+from the root directory, execute
 
-    cd src
     python setup.py build
     python setup.py install
 

Makefile.am

@@ -1,6 +1,6 @@
 ##
 ## This file is part of Gambit
-## Copyright (c) 1994-2014, The Gambit Project (http://www.gambit-project.org)
+## Copyright (c) 1994-2023, The Gambit Project (http://www.gambit-project.org)
 ##
 ## FILE: Makefile.am
 ## Top-level automake input file for Gambit

README.md

@@ -1,10 +1,33 @@
-# Gambit
+<h1 style="text-align: center;">
+<img src="https://raw.githubusercontent.com/gambitproject/gambit/master/doc/_static/gambit.png"
+     width="300" alt="Gambit logo">
+</h1>
+<br/>
 
-This is the README file for Gambit, software tools for game theory.
+![Latest development version](https://img.shields.io/github/downloads-pre/gambitproject/gambit/latest/total?label=Latest%20development%20version)
+![PyPI - Version](https://img.shields.io/pypi/v/pygambit?label=PyPI%20version)
+![PyPI - Downloads](https://img.shields.io/pypi/dm/pygambit?label=PyPI%20downloads)
+![PyPI - License](https://img.shields.io/pypi/l/pygambit)
 
-The latest information on Gambit can be obtained from the
-Gambit website at
-http://www.gambit-project.org
 
-Instructions on installing Gambit can be found in the
-file [INSTALL.md](INSTALL.md) in this directory.
+**Gambit** is the package for doing computation in (non-cooperative) game theory.
+
+Gambit provides:
+
+- Structures to represent games in extensive and strategic form
+- Methods for building and modifying games
+- Representations of mixed strategy and mixed behavior profiles
+- Many algorithms for computing one or more Nash equilibria of games
+- Facilities for computing quantal response equilibria and fitting QREs to data
+
+
+## How to get Gambit
+
+Gambit's GitHub repository is at https://github.com/gambitproject/gambit.
+
+Official Gambit releases are available from
+[the releases section of the repository](https://github.com/gambitproject/gambit/releases)
+
+Gambit offers [the Python package `pygambit`](https://pypi.org/project/pygambit/),
+installable via PyPI.
+

configure.ac

@@ -1,6 +1,6 @@
 dnl
 dnl This file is part of Gambit
-dnl Copyright (c) 1994-2022, The Gambit Project (http://www.gambit-project.org)
+dnl Copyright (c) 1994-2023, The Gambit Project (http://www.gambit-project.org)
 dnl
 dnl FILE: configure.ac
 dnl autoconf configuration script for Gambit

contrib/Makefile.am

@@ -1,6 +1,6 @@
 ##
 ## This file is part of Gambit
-## Copyright (c) 1994-2013, The Gambit Project (http://www.gambit-project.org)
+## Copyright (c) 1994-2023, The Gambit Project (http://www.gambit-project.org)
 ##
 ## FILE: contrib/Makefile.am
 ## automake input file for contrib subdirectory

contrib/mac/Info.plist

@@ -19,15 +19,15 @@
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>16.0.2</string>
+	<string>16.1.0a</string>
 	<key>CFBundleShortVersionString</key>
-	<string>16.0.2</string>
+	<string>16.1.0a</string>
 	<key>CFBundleGetInfoString</key>
-	<string>Gambit version 16.0.2, (c) 1994-2022 The Gambit Project</string>
+	<string>Gambit version 16.1.0a, (c) 1994-2023 The Gambit Project</string>
 	<key>CFBundleLongVersionString</key>
-	<string>16.0.2, (c) 1994-2022 The Gambit Project</string>
+	<string>16.1.0a, (c) 1994-2023 The Gambit Project</string>
 	<key>NSHumanReadableCopyright</key>
-	<string>Copyright 1994-2022 The Gambit Project</string>
+	<string>Copyright 1994-2023 The Gambit Project</string>
 	<key>LSRequiresCarbon</key>
 	<true/>
 	<key>CSResourcesFileMapped</key>

contrib/scripts/Makefile.am

@@ -1,6 +1,6 @@
 ##
 ## This file is part of Gambit
-## Copyright (c) 1994-2013, The Gambit Project (http://www.gambit-project.org)
+## Copyright (c) 1994-2023, The Gambit Project (http://www.gambit-project.org)
 ##
 ## FILE: contrib/scripts/Makefile.am
 ## automake input for sample scripts directory

doc/conf.py

@@ -48,9 +48,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '16.0'
+version = '16.1'
 # The full version, including alpha/beta/rc tags.
-release = '16.0.2'
+release = '16.1.0a1'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

doc/index.rst

@@ -34,8 +34,8 @@ If you are citing Gambit in a paper, we suggest a citation of the form:
 
   McKelvey, Richard D., McLennan, Andrew M., and 
   `Turocy, Theodore L. <http://www.gambit-project.org/turocy>`__
-  (2014).
-  Gambit: Software Tools for Game Theory, Version 16.0.2.
+  (2023).
+  Gambit: Software Tools for Game Theory, Version 16.1.0.
   http://www.gambit-project.org.
 
 Replace the version number and year as appropriate if you use a

doc/intro.rst

@@ -181,41 +181,15 @@ include:
 Downloading Gambit
 ------------------
 
-Gambit operates on an annual release cycle roughly mirroring the
-(northern hemisphere) academic year.  A new version is promoted to
-stable/teaching each August; the major version number is equal to the
-last two digits of the year in which the version becomes stable.
-
-This document covers Gambit 16.0.2.
-You can download it from
-`Sourceforge
-<http://sourceforge.net/projects/gambit/files/gambit16/16.0.1>`_.
-Full source code is available, as are precompiled binaries for
-Microsoft Windows and Mac OS X.
+Gambit source code and built binaries can be downloaded from the project
+`GitHub repository releases section`<https://github.com/gambitproject/gambit/releases>.
 
 Older versions of Gambit can be downloaded from
 `http://sourceforge.net/projects/gambit/files
 <http://sourceforge.net/projects/gambit/files>`_.  Support for older
 versions is limited.
 
 
-Community
----------
-
-The following mailing lists are available for those interested in the
-use and further development of Gambit:
-
-`gambit-announce@lists.sourceforge.net <http://lists.sourceforge.net/lists/listinfo/gambit-announce>`_
-  Announcement-only mailing list for notifications of new releases of
-  Gambit.
-
-`gambit-users@lists.sourceforge.net <http://lists.sourceforge.net/lists/listinfo/gambit-users>`_
-  General discussion forum for teaching and research users of Gambit.
-
-`gambit-devel@lists.sourceforge.net <http://lists.sourceforge.net/lists/listinfo/gambit-devel>`_
-  Discussion for those interested in devleoping or extending Gambit, 
-  or using Gambit source code in other applications.
-
 Bug reports
 -----------
 

doc/tools.rst

@@ -101,7 +101,7 @@ Computing the pure-strategy equilibria of extensive game :download:`e02.efg
 
    $ gambit-enumpure e02.efg
    Search for Nash equilibria in pure strategies
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    This is free software, distributed under the GNU GPL
 
    NE,1,0,0,0,1,0
@@ -112,7 +112,7 @@ strategies::
 
    $ gambit-enumpure -S e02.efg
    Search for Nash equilibria in pure strategies
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    This is free software, distributed under the GNU GPL
 
    NE,1,0,0,1,0
@@ -123,7 +123,7 @@ only one information set; therefore the set of solutions is larger::
 
    $ gambit-enumpure -A e02.efg   
    Search for Nash equilibria in pure strategies
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    This is free software, distributed under the GNU GPL
 
    NE,1,0,1,0,1,0
@@ -209,7 +209,7 @@ Computing equilbria of the extensive game :download:`e01.efg
 
    $ gambit-enumpoly e01.efg 
    Compute Nash equilibria by solving polynomial systems
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    Heuristic search implementation Copyright (C) 2006, Litao Wei 
    This is free software, distributed under the GNU GPL
 
@@ -291,7 +291,7 @@ in Figure 2 of Selten (International Journal of Game Theory,
 
    $ gambit-enummixed e02.nfg
    Compute Nash equilibria by enumerating extreme points
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    Enumeration code based on lrslib 4.2b, 
    Copyright (C) 1995-2005 by David Avis (avis@cs.mcgill.ca)
    This is free software, distributed under the GNU GPL
@@ -305,7 +305,7 @@ information using the `-c` switch::
   
    $ gambit-enummixed -c e02.nfg
    Compute Nash equilibria by enumerating extreme points
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    Enumeration code based on lrslib 4.2b, 
    Copyright (C) 1995-2005 by David Avis (avis@cs.mcgill.ca)
    This is free software, distributed under the GNU GPL
@@ -365,7 +365,7 @@ the reduced strategic form of the example in Figure 2 of Selten
     $ gambit-gnm e02.nfg
     Compute Nash equilibria using a global Newton method
     Gametracer version 0.2, Copyright (C) 2002, Ben Blum and Christian Shelton
-    Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+    Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
     This is free software, distributed under the GNU GPL
 
     NE,1,0,2.99905e-12,0.5,0.5
@@ -415,7 +415,7 @@ the reduced strategic form of the example in Figure 2 of Selten
    $ gambit-ipa e02.nfg
    Compute Nash equilibria using iterated polymatrix approximation
    Gametracer version 0.2, Copyright (C) 2002, Ben Blum and Christian Shelton
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    This is free software, distributed under the GNU GPL
 
    NE,1.000000,0.000000,0.000000,1.000000,0.000000
@@ -506,7 +506,7 @@ Computing an equilibrium of extensive game :download:`e02.efg
 
    $ gambit-lcp e02.efg
    Compute Nash equilibria by solving a linear complementarity program
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    This is free software, distributed under the GNU GPL
 
    NE,1,0,1/2,1/2,1/2,1/2
@@ -579,7 +579,7 @@ strategies each, with a unique equilibrium in mixed strategies::
 
    $ gambit-lp 2x2const.nfg
    Compute Nash equilibria by solving a linear program
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    This is free software, distributed under the GNU GPL
 
    NE,1/3,2/3,1/3,2/3
@@ -652,7 +652,7 @@ Computing an equilibrium in mixed strategies of :download:`e02.efg
 
    $ gambit-liap e02.nfg
    Compute Nash equilibria by minimizing the Lyapunov function
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    This is free software, distributed under the GNU GPL
 
    NE, 0.998701, 0.000229, 0.001070, 0.618833, 0.381167
@@ -735,7 +735,7 @@ Computing an equilibrium in mixed strategies of :download:`e02.efg
  
    $ gambit-simpdiv e02.nfg 
    Compute Nash equilibria using simplicial subdivision
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    This is free software, distributed under the GNU GPL
 
    NE,1,0,0,1,0
@@ -835,7 +835,7 @@ in Figure 2 of Selten (International Journal of Game Theory,
 
    $ gambit-logit e02.nfg
    Compute a branch of the logit equilibrium correspondence
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    This is free software, distributed under the GNU GPL
 
    0.000000,0.333333,0.333333,0.333333,0.5,0.5
@@ -896,7 +896,7 @@ Example invocation for HTML output::
 
    $ gambit-convert -O html 2x2.nfg
    Convert games among various file formats
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    This is free software, distributed under the GNU GPL
 
    <center><h1>Two person 2 x 2 game with unique mixed equilibrium</h1></center>
@@ -911,7 +911,7 @@ Example invocation for LaTeX output::
 
    $ gambit-convert -O sgame 2x2.nfg
    Convert games among various file formats
-   Gambit version 16.0.2, Copyright (C) 1994-2022, The Gambit Project
+   Gambit version 16.0.2, Copyright (C) 1994-2023, The Gambit Project
    This is free software, distributed under the GNU GPL
 
    \begin{game}{2}{2}[Player 1][Player 2]

gambit.wxs

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
-    <Product Id="8EE11AE3-2B91-4870-895B-44C46D648BD6" Name="Gambit 16" Language="1033" Version="16.0.2" Manufacturer="The Gambit Project" UpgradeCode="135FFB28-DA7C-427C-A3DA-783B805BCC22">
+    <Product Id="8EE11AE3-2B91-4870-895B-44C46D648BD6" Name="Gambit 16" Language="1033" Version="16.1.0" Manufacturer="The Gambit Project" UpgradeCode="135FFB28-DA7C-427C-A3DA-783B805BCC22">
         <Package Description="Gambit" Comments="Software Tools for Game Theory" InstallerVersion="200" Compressed="yes" />
         <Media Id="1" Cabinet="gambit.cab" EmbedCab="yes" />