Differences between revisions 92 and 184 (spanning 92 versions)
Revision 92 as of 2009-07-09 19:24:59
Size: 6773
Editor: RalfHemmecke
Comment:
Revision 184 as of 2022-04-05 01:35:07
Size: 11339
Editor: mkoeppe
Comment: remove broken links
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Sage-Combinat = = Sage-Combinat: enhancing Sage as a toolbox for computer exploration in algebraic combinatorics =
Line 3: Line 3:
Sage-Combinat is a software project whose mission statement is: '''to improve the open source mathematical system [[http://www.sagemath.org/|Sage]] as an extensible toolbox for computer exploration in algebraic combinatorics, and foster code sharing between researchers in this area'''. Sage-Combinat is a software project whose mission is: '''to improve the open source mathematical system [[https://www.sagemath.org/|Sage]] as an extensible toolbox for computer exploration in (algebraic) combinatorics, and foster code sharing between researchers in this area'''.
Line 5: Line 5:
In practice, Sage-combinat is a collection of experimental patches (i.e. extensions) on top of [[http://www.sagemath.org/|Sage]], developed by a community of researchers. The intent is that most of those patches get eventually integrated into Sage as soon as they are mature enough, with a typical short life-cycle of a few weeks. In other words: just install Sage, and you will benefit from all the Sage-combinat development, except for the latest bleeding edge features.

----

== Installation instructions ==

=== Short instructions ===

'''Step 1.''' To install the experimental patches provided by Sage-combinat, you first need to install Sage. You have two options.

    1. Binary installation (takes less time; only option on Windows; only works if a binary exists for your system):

        * Download a binary distribution ''for your system'' from [[http://sagemath.org/download.html]] and follow the installation instructions on that page.

    2. Source installation (recommended, but time-consuming; works for Linux and OSX as long as you have a compilier):

        * Download the source code from [[http://sagemath.org/download-source.html]] and follow the installation instructions on that page.

'''Step 2.''' Install the Sage-Combinat patches by running the following command ''inside the sage directory'':
    {{{
./sage -combinat install
    }}}
(note: this may require Sage 4.1 which will be out shortly).
If this step fails, please send an email to the
[[http://groups.google.com/group/sage-combinat-devel|sage-combinat-devel]]
mailing list with the error message.

=== Long instructions ===

 * See the [[http://wiki.sagemath.org/combinat/MercurialStepByStep|Patch server Step by step tutorial]] (in particular, how to '''download Sage-Combinat''')
In practice, Sage-combinat is a collection of branches on top of [[https://www.sagemath.org/|Sage]], developed by a community of researchers. The intent is that most of those branches get eventually integrated into Sage as soon as they are mature enough, with a typical short life-cycle of a few weeks. In other words: just install Sage, and you will benefit from all the Sage-combinat development, except for the latest bleeding edge features.
Line 39: Line 10:
 * [[http://sagetrac.org/sage_trac/wiki/SageCombinatRoadMap|road map and current status]]
Line 41: Line 11:
 * February 22-26, 2010: [[http://wiki.sagemath.org/daysmarseille|Sage days]]
   The thematic month [[https://www.lirmm.fr/arith/wiki/MathInfo2010/MathInfo2010|MathInfo 2010]] at CIRM, Marseille will include a Sage days session. FlorentHivert, NicolasThiéry, and FrancoSaliola will be among the organizers, there will be a serious combinatorics slant.
   
 * July 25-29, 2009: *-Combinat 2009
 * [[https://trac.sagemath.org/sage_trac/wiki/SageCombinatRoadMap|Road map and current status]]
Line 46: Line 13:
   We will hold an International Sage Workshop on [[http:/combinat/FPSAC09|Free and Practical Software for Algebraic Combinatorics]] at RISC, Linz, Austria, right after [[http://www.risc.uni-linz.ac.at/about/conferences/fpsac2009/|FPSAC'09]]  * [[https://combinat.sagemath.org:8080|Experimental Sage notebook with the Sage-Combinat patches applied]]

 * A new [[https://combinat.sagemath.org/misc/raw-file/tip/articles/2013-01-17-Poster/main2014.pdf|poster]] for Sage-Combinat!

 * [[https://wiki.sagemath.org/TentativeConventions|Help for new Git workflow]]

== Past news ==

 * June 8-12, 2015 [[http://gauss.math.luc.edu/sagedays/|Sage Days 65]], Loyola University Chicago, USA
   Organized by Mark V. Albert, Aaron Lauve, Peter Tingley

 * April 13-16, 2015 [[https://wiki.sagemath.org/days67|Sage Days 67]], UQAM, Canada
   Organized by Mathieu Guay-Paquet, Viviane Pons, Franco Saliola

 * March 17-20, 2015 [[https://wiki.sagemath.org/days64|Sage Days 64]], University of California at Davis, USA
   Organized by Dan Bump, Anne Schilling and Travis Scrimshaw

 * August 14-17, 2014 [[https://wiki.sagemath.org/days60|Sage Days 60]], Chennai, India

 * April 7-11, 2014 [[https://wiki.sagemath.org/days57|Sage(-Combinat) Days 57]], Cernay, France

 * November 4-8, 2013 [[https://wiki.sagemath.org/days54|Sage(-Combinat) Days 54]], University of California at Davis, USA
   Organized by Dan Bump, Anne Schilling and Travis Scrimshaw

 * June 17-21, 2013 [[combinat/FPSAC13|Sage(-Combinat) days 49]], in Orsay as satellite event to [[https://www.liafa.jussieu.fr/fpsac13/|FPSAC'13]]
   Organized by Alejandro Morales, Anne Schilling, Nicolas M. Thiery

 * January 28 - May 3, 2013: [[https://icerm.brown.edu/sp-s13/|ICERM Semester Program on "Automorphic Forms, Combinatorial Representation Theory and Multiple Dirichlet Series"]], with a strong Sage and Sage-Combinat component, ICERM, Brown, USA

 * February 11-15, 2013 [[https://icerm.brown.edu/sp-s13/|Sage Days: Multiple Dirichlet Series, Combinatorics, and Representation Theory]], ICERM, Brown, USA
   Organized by Franco Saliola, Anne Schilling, Nicolas M. Thiery

 * January 21-25, 2013 [[http://www.aimath.org/ARCC/workshops/onlinedata.html|Online Databases:from L-functions to combinatorics]], Edinburgh
   Organized by Paul-Olivier DeHaye, Nicolas M. Thiery.

 * October 29 - November 9, 2012: [[http://www.cimpa-icpam.org/spip.php?article430|CIMPA summer school Discrete mathematics : combinatorial, dynamical and algorithmic aspects]], with a strong Sage and Sage-Combinat component, Bobo Dioulasso, Burkina Faso

 * July 9-13 2012: [[http://www.ima.umn.edu/2011-2012/SW7.9-13.12/|Sage(-Combinat) Days 40]]: Algebraic Combinatorics, IMA, Minneapolis, USA
   Organized by Gregg Musiker, Franco Saliola, Anne Schilling, Nicolas M. Thiery.

 * May 7-11 2012: [[https://wiki.sagemath.org/days38|Sage(-Combinat) Days 38]]: algebraic combinatorics and the representation theory of algebras, Centre de recherches mathématiques, Montréal, Canada

 * April 18-th 2012: Coxeter/Cluster algebra afternoon at the [[https://wiki.sagemath.org/GroupeUtilisateursParis|Paris Sage User Group meeting]]

 * February 8-10 2012: [[combinat/ClusterPackageDaysHannover|Sage and cluster algebra workshop, University of Hannover]]

 * February 6-10 2012: [[combinat/SageCombinatDaysCernay2012|Sage-Combinat Days Cernay 2012]]

 * March 19-23 2012: [[combinat/EjcGdrIm2012|EJC du GDR-im]] a Rennes [[http://ejcim2012.irisa.fr/index.html|site officiel]]

 * May 2-6, 2011: [[https://wiki.sagemath.org/days30| Sage Days 30]]: Combinatorics (Schubert calculus, cluster algebras) and Number theory (integer vectors, multidimensional digit representations) in Acadia University, Wolfville, Nova Scotia, Canada
   Organized by Eva Curry and Hugh Thomas.

 * January 17-19, 2011: [[https://wiki.sagemath.org/days28|Sage days 28]]: dynamics, geometry, and analytic combinatorics in Orsay

 * July 10, 2010: First release of [[http://sagebook.gforge.inria.fr/|Calcul Mathématique avec Sage]]
   A 315 pages open source french introductory book on computational mathematics, illustrated in Sage, and including a 35 pages chapter on combinatorics (and soon one on graph theory).

 * July 7-15, 2010: [[combinat/AffineSchubertCalculusWorkshop|Affine Schubert Calculus workshop and summer school in Toronto]]
   It includes several Sage and Sage-Combinat sessions.
   Organized by Anne Schilling and Mike Zabrocki.

 * June 14-18, 2010: [[combinat/SageCombinatChevieWorkshopOrsay2010|Joint Sage-Combinat and Chevie Workshop in Orsay]]

 * May 3-7, 2010: [[http://www.fields.utoronto.ca/programs/scientific/09-10/sage/|Sage Days 20.5 in Toronto]]
   Organized by Nantel Bergeron, FrancoSaliola and Mike Zabrocki,
   again with a serious algebraic combinatorics slant

 * February 22-26, 2010: [[https://wiki.sagemath.org/daysmarseille|Sage days 20]]
   The thematic month [[https://www.lirmm.fr/arith/wiki/MathInfo2010/MathInfo2010|MathInfo 2010]] at CIRM, Marseille included a Sage days week. FlorentHivert, NicolasThiéry, and FrancoSaliola were among the organizers and there was a serious combinatorics slant.

 * July 25-29, 2009: [[combinat/FPSAC09|*-Combinat 2009]]

   We held an International Sage Workshop on [[combinat/FPSAC09|Free and Practical Software for Algebraic Combinatorics]] at RISC, Linz, Austria, right after [[http://www.risc.uni-linz.ac.at/about/conferences/fpsac2009/|FPSAC'09]]
Line 54: Line 94:
 * January 26-30, 2009: [[http:/combinat/SageCombinatWorkshopOrsay|Sage-Combinat Workshop in Orsay]]  * January 26-30, 2009: [[combinat/SageCombinatWorkshopOrsay|Sage-Combinat Workshop in Orsay]]
Line 60: Line 100:
   The transition is a massive investment: seven years of hard work to port over! However a lot of experience was gained since 2000, and most of the design is now pretty clear. By sharing the work the transition will hopefuly be relatively quick.    The transition was a massive investment (and is not yet completely
   over)
: seven years of hard work to port over! However a lot of
  
experience was gained since 2000, and most of the design was pretty
   clear, and we co
uld *share* the work.
Line 64: Line 107:
== Who are we? == == Who are we? What is Sage-Combinat used for? ==
Line 66: Line 109:
 * [[http://wiki.sagemath.org/combinat/Contributors|Contributors]]  * [[combinat/Contributors|Contributors]]
Line 68: Line 111:
 * [[http://wiki.sagemath.org/combinat/Institutions|Institutions and sponsors]]  * [[combinat/Institutions|Institutions and sponsors]]

 * [[combinat/Grants|Grant applications]]

 * [[http://www.sagemath.org/library-publications-combinat.html|Publications citing Sage-Combinat]]

 * [[combinat/CiteSageCombinat|Cite Sage-Combinat]] when you use it for research publications.

 * Plume's review pages on Sage-Combinat: [[http://www.projet-plume.org/en/relier/sage-combinat-0|English]] and [[http://www.projet-plume.org/fr/relier/sage-combinat|French]]

 * [[http://combinat.sagemath.org/misc/raw-file/tip/articles/2013-01-17-Poster/main.pdf|Sage-Combinat's poster]]

 * [[combinat/CoolPictures|Cool pictures we produced with Sage-Combinat for our research]]
Line 79: Line 134:
    * [[http://groups.google.com/group/sage-combinat-devel|sage-combinat-devel]]: Developpers mailing list     * [[http://groups.google.com/group/sage-combinat-devel|sage-combinat-devel]]: Developers' mailing list
Line 81: Line 136:
 * Check the [[http://sagetrac.org/sage_trac/wiki/SageCombinatRoadMap|road map and current status]] 
 * Post bug reports, suggestions, patches on the [[http://sagetrac.org/sage_trac/milestone/sage-combinat|Sage-Combinat trac server]] or on the [[http://groups.google.com/group/sage-combinat-devel|mailing list]].
   * Cite Sage-Combinat when you use it for research publications (TODO: provide a standard citation here).
    * [[http://groups.google.com/group/sage-combinat-days|sage-combinat-days]]: Mailing list for the organisation of Sage-Combinat days
 * C
heck the [[http://trac.sagemath.org/sage_trac/wiki/SageCombinatRoadMap|road map and current status]]
 * Post bug reports, suggestions, patches on the [[http://trac.sagemath.org/sage_trac/milestone/sage-combinat|Sage-Combinat trac server]] or on the [[http://groups.google.com/group/sage-combinat-devel|mailing list]].
Line 87: Line 141:
  Since Sage 6.0, the
[[http://trac.sagemath.org/wiki/QuickStartSageGit|development workflow]]
has been reworked in depth, and we are in the progress of migrating
the extensions as git branches. Here are some useful links:
Line 88: Line 147:
 * The collection of patches is managed using a [[http://combinat.sagemath.org/patches/|patch server]] (mercurial queues). Use it to try out the latest experimental features, or contribute your own patches! (You may still need to access to the [[http://sage.math.washington.edu:2144/|old patch server]])  * [[http://trac.sagemath.org/query?status=closed&component=combinatorics&or&status=closed&cc=~sage-combinat&col=id&col=summary&col=component&col=status&col=type&col=priority&col=milestone&order=priority|Closed tickets related to combinatorics]]
Line 90: Line 149:
 * Please read the [[http://wiki.sagemath.org/combinat/MercurialStepByStep|Step by step tutorial]] (in particular, how to '''download Sage-Combinat''')  * [[http://trac.sagemath.org/query?status=needs_info&status=needs_review&status=needs_work&status=positive_review&component=combinatorics&or&status=needs_info&status=needs_review&status=needs_work&status=positive_review&cc=~sage-combinat&col=id&col=summary&col=component&col=status&col=type&col=priority&col=milestone&order=priority|In-progress tickets related to combinatorics]]
Line 92: Line 151:
 * For the curious: [[http://wiki.sagemath.org/combinat/Mercurial|Technical background on the Sage-Combinat patch server (messy)]].  * [[https://wiki.sagemath.org/TentativeConventions|Some conventions and help with the new git]]
Line 94: Line 153:
 * For hg lovers: [[http://hgbook.red-bean.com/read/|Mercurial: The Definite Guide]] an e-book by Bryan O'Sullivan
Line 96: Line 154:
 * [[http://combinat.sagemath.org/misc/file/|Mercurial server for miscelleanous files and documents]]
   To check them out, use {{{hg clone http://combinat.sagemath.org/misc/ Sage-Combinat-misc-file}}}. This will create a subdirectory {{{Sage-Combinat-misc-file}}} in the current directory; you can use any other name for this subdirectory.
The Sage-Combinat extensions used to be managed as a collection of
patches on our [[http://combinat.sagemath.org/patches/|patch server]],
using a so-called mercurial queue.
Quite some stuff below is thus outdated, and will be progressively
replaced by information on the new workflow.

 * Browse the [[http://combinat.sagemath.org/code/file/tip/sage/|Sage sources with the Sage-combinat patches applied]] (only useful for Sage version prior to sage-6.0)

 * Developing for Sage-Combinat on Windows: [[combinat/SageDevelWindows|Sage Development on Windows]].
Line 101: Line 166:
 * Have a look and participate to [[http:/combinat/DesignDiscussion|design discussions]].  * Have a look and participate to [[combinat/DesignDiscussion|design discussions]].
Line 103: Line 168:
 * Contribute to the list of [[http:/combinat/Weirdness|quirks and weirdness issues]] in the {{{*-Combinat}}} design.  * Contribute to the list of [[combinat/Weirdness|quirks and weirdness issues]] in the {{{*-Combinat}}} design.
Line 107: Line 172:
 * From sage 3.4 on, the documentation system is based on ReST/Sphinx. Here are some [[combinat/HelpOnTheDoc|help about the new doc system]]  * [[combinat/HelpOnTheDoc|Some tips and tricks about the documentation system]]

== Links ==

 * The [[http://www.mat.univie.ac.at/~slc/divers/software.html|Combinatorial Software and Databases]] web page maintained by Christian Krattenthaler

Sage-Combinat: enhancing Sage as a toolbox for computer exploration in algebraic combinatorics

Sage-Combinat is a software project whose mission is: to improve the open source mathematical system Sage as an extensible toolbox for computer exploration in (algebraic) combinatorics, and foster code sharing between researchers in this area.

In practice, Sage-combinat is a collection of branches on top of Sage, developed by a community of researchers. The intent is that most of those branches get eventually integrated into Sage as soon as they are mature enough, with a typical short life-cycle of a few weeks. In other words: just install Sage, and you will benefit from all the Sage-combinat development, except for the latest bleeding edge features.


NEWS

Past news


Who are we? What is Sage-Combinat used for?


How to participate and contribute

Communication

Code

Since Sage 6.0, the development workflow has been reworked in depth, and we are in the progress of migrating the extensions as git branches. Here are some useful links:

The Sage-Combinat extensions used to be managed as a collection of patches on our patch server, using a so-called mercurial queue. Quite some stuff below is thus outdated, and will be progressively replaced by information on the new workflow.

Design

Documentation

combinat (last edited 2022-04-05 01:35:07 by mkoeppe)