- What software is available in the COIN-OR repository and how is it organized?
- What is the maturity level of a project?
- What is a stable version? What is a stable release?
- How do I obtain the source code for a COIN-OR project?
- How do I use Subversion to obtain the source code for a COIN-OR project?
- What is Trac and how do I use it?
- How do I edit a wiki page for a project?
- How do I compile, link, and run the COIN-OR code?
- What licenses are COIN-OR projects distributed under?
- Who do I contact for COIN-OR related questions?
- Where do bugs get reported?
- How is the COIN-OR project managed?
- How can I help?
- Where does the name COIN-OR come from?
- Why is the web site url www.coin-or.org and not www.coin.org?
- I'd like to cite COIN-OR. I notice several publications, is there some standard paper that is typically cited?
- Level 0: A proposed project for which substantial development has yet to commence.
- Level 1: Projects that don’t work yet or don’t meet the requirements for becoming a Level 2 project.
- Level 2: Projects that build and do something useful.
- Level 3: Level 2 projects that also have substantial documentation, tutorials, examples codes, or other aids to enhance usability.
- Level 4: Level 3 projects that have versioning, a stable release (see below), and a susbtantial unit test.
- Level 5: Level 4 projects that are part of the binary distribution.
A stable version is created whenever the project manager wishes to declare a new version of the project. Creating a stable version means roughly that the feature set and API associated with that particular version are frozen, but the code may continue to evolve through the application of patches to fix bugs, the addition of documentation, etc. Such a stable version is identified by a two-digit version number (i.e., 5.1). Stable versions continue to evolve, but this evolution should generally consist of bug fixes and minor tweaking only—development of new features is reserved for future versions. The current stable version of a project can generally only be obtained using a SVN client (see below).
A stable release is a fixed snapshot of a stable version identified by a three-digit release number (i.e., 5.1.1). Stable releases can be obtained either using a SVN client or by downloading a source archive (see next question).
Source code for archived stable releases of each project are available in compressed format here.
The source code for a project can also be obtained using COIN-OR’s version control system, which is Subversion (SVN). Basic instructions for obtaining source code using SVN are avalable below. More extensive help is available here.
UNIX: Follow these instructions for Unix™-like environments:
- Make sure you have Subversion installed on your system.
- Issue (for any shell)
svn co https://projects.coin-or.org/svn/Pkg/path/to/version Coin-Pkg
where Pkg is any of the project names on the projects page and /path/to/version is the path to the version of the code you want to download (please see the project’s Web page for the appropriate path). Subversion will obtain the source for the project along with the source of any dependent projects.
Windows: Using the TortoiseSVN client:
- Install TortoiseSVN on your system.
- Select a directory in windows explorer where you want to place your working copy. Right click to pop up the context menu and select the command ,which brings up the following dialog box:
where Pkg is any of the project names on the projects page and /path/to/version is the path to the version of the code you want to download (please see the project’s Web page for the appropriate path).
Trac is the software we use for hosting the project management Web sites. It is based on a fairly intuitive Wiki, but before editing the wiki pages or submitting a trouble ticket, you must become a registered user and log in. For instructions on how to do this, please go here.
Before editing the wiki pages or submitting a trouble ticket, you must become a registered user and log in. For instructions on how to do this, please go here.
Most current COIN-OR projects use the Eclipse Public License and this is the license we recommend. However, we accept projects licensed under any license officially approved by the Open Source Initiative. The author of the EPL is the Eclipse Foundation, and they have an EPL FAQ, based on their understanding of the EPL.
Go to the project’s Web site (see the projects page for a list). Then become a registered user and log in following the instructions here. Finally, create a new trouble ticket. Alternatively, you may send a short email to the appropriate mailing list describing the bug. If you are uncertain which list is appropriate, see the projects page for a list or use firstname.lastname@example.org for general questions.
The COIN-OR project is managed by the COIN-OR Foundation, Inc., a non-profit educational foundation. More details are available on the COIN-OR Foundation page.
Glad you asked! Check out the how to help page for some ideas on getting started.
At its incarnation, COIN-OR was known as the “Common Optimization Interface for OR”. The name (but not the acronym) was later changed to better reflect that COIN-OR is intended to host all types of OR software, not just “optimization” software.
Because there is another open source project which uses the name COIN and someone else already had the url www.coin.org (but don’t go there; it’s been flagged for bad behaviour).