1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
[](https://gitlab.inria.fr/math-comp/math-comp/commits/master)
[](https://coq.zulipchat.com/#narrow/stream/237664-math-comp-users)
# The Mathematical Components repository
The Mathematical Components Library is an extensive and coherent
repository of formalized mathematical theories. It is based on
the [Coq/Rocq](http://coq.inria.fr) proof assistant, powered with the
[SSReflect](https://coq.inria.fr/refman/proof-engine/ssreflect-proof-language.html)
language.
These formal theories cover a wide spectrum of topics, ranging from the formal theory of general purpose data structures like [lists](ssreflect/seq.v), [prime numbers](ssreflect/prime.v) or [finite graphs](ssreflect/fingraph.v), to advanced topics in algebra. The repository includes the foundation of formal theories used in a [formal proof](https://www.ams.org/notices/200811/tx081101382p.pdf) of the [Four Colour Theorem](https://en.wikipedia.org/wiki/Four_color_theorem) (Appel-Haken, 1976) and a [mechanization](https://hal.archives-ouvertes.fr/hal-00816699/) of the [Odd Order Theorem](https://en.wikipedia.org/wiki/Feit%E2%80%93Thompson_theorem) (Feit-Thompson, 1963), a landmark result of finite group theory, which utilizes the library extensively.
## Installation
If you already have OPAM installed (a fresh or up to date version of opam 2 is required):
```
opam repo add rocq-released https://rocq-prover.org/opam/released
opam install rocq-mathcomp-boot
```
Additional packages go by the name of `rocq-mathcomp-algebra`,
`rocq-mathcomp-field`, etc... See [INSTALL](INSTALL.md) for detailed
installation instructions in other scenarios.
## How to get help
- The [website](http://math-comp.github.io/math-comp/) of the MathComp library
contains:
+ links to the [HTML documentation of the last version](https://math-comp.github.io/htmldoc/libgraph.html) as well as the documentation of previous versions,
+ a list of [tutorials](https://math-comp.github.io/documentation.html).
- The [Mathematical Components Book](https://math-comp.github.io/mcb/)
provides a comprehensive introduction to the library.
- Experienced users hang around at
[StackOverflow](https://stackoverflow.com/questions/tagged/ssreflect)
listening to the `ssreflect` and `coq` tags.
- The primary venue for help and questions about the library nowadays
is [Zulip](https://rocq-prover.zulipchat.com/).
- Developers and users can also be reached via
the [ssreflect mailing list](https://sympa.inria.fr/sympa/info/ssreflect) (low volume).
### About the stability of the MathComp library
- The MathComp library has been regularly released since 2008.
Recently, we have been releasing a new version twice a year,
in line with the released of the [Coq/Rocq](http://coq.inria.fr) proof assistant.
- Changes are documented systematically in [CHANGELOG.md](CHANGELOG.md) for releases
and [doc/changelog](doc/changelog) for unreleased changes.
- We use deprecation warnings to help transitioning to new versions
(see [CONTRIBUTING.md](CONTRIBUTING.md#Deprecations) for details about the deprecation policy).
## Publications and Tools using MathComp
[A collection of papers using the Mathematical Components library](https://math-comp.github.io/papers.html)
|
