File: README.rst

package info (click to toggle)
mshr 2018.1.0+dfsg1-7
  • links: PTS, VCS
  • area: main
  • in suites: buster, sid
  • size: 1,136 kB
  • sloc: cpp: 9,808; python: 680; makefile: 242; sh: 62; ansic: 11
file content (81 lines) | stat: -rw-r--r-- 2,392 bytes parent folder | download | duplicates (2)
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
====
mshr
====

mshr is the mesh generation component of `FEniCS
<http://fenicsproject.org/>`_. It generates simplicial `DOLFIN
<https://bitbucket.org/fenics-project/dolfin>`_ meshes in 2D and 3D
from geometries described by Constructive Solid Geometry (CSG) or from
surface files, utilizing CGAL and Tetgen as mesh generation backends.

Authors:
  | Benjamin Kehlet <benjamik@simula.no>

Contributors:
  | Anders Logg     <logg@chalmers.se>
  | Johannes Ring   <johannr@simula.no>
  | Garth N. Wells  <gnw20@cam.ac.uk>

Documentation
=============

The documentation is currently being prepared here: 
`https://bitbucket.org/fenics-project/mshr/wiki <https://bitbucket.org/fenics-project/mshr/wiki>`_

Installation
============
For Debian and Ubuntu users, installing mshr is as easy as::

  sudo apt-get install fenics

To get a recent version of, enable the FEniCS PPA first. See `Installation instructions for Ubuntu <http://fenicsproject.org/download/ubuntu_details.html>`_

To build mshr from source, run::

  cmake <path to mshr source tree>
  make
  make install

mshr's build script will also build CGAL and Tetgen from source and
include them in the binary.

Dependencies
============

mshr needs `DOLFIN <https://bitbucket.org/fenics-project/dolfin>`_
with Python support (pyDolfin). `CGAL <http://www.cgal.org/>`_ and
`Tetgen <http://www.tetgen.org>`_ are shipped with mshr and built from
source automatically. CGAL needs `Gnu GMP <https://gmplib.org/>`_ and
`Gnu MPFR <http://www.mpfr.org/>`_.

License
=======

mshr is licensed under GPL version 3 or (at your option) any later
version.

Contact
=======

mshr is hosted at https://bitbucket.org/fenics-project/mshr/

For comments and requests, send an email to the FEniCS mailing list::

 fenics@fenicsproject.org

For bug reports and feature requests, visit mshr's issue tracker at BitBucket::

 https://bitbucket.org/fenics-project/mshr/issues

Contributions
=============

Contributions are welcome!

Please read about contributing to FEniCS here:
http://fenicsproject.org/contributing/

If you plan to implement a new feature, please discuss it at the
FEniCS mailing list beforehand. Smaller patches and bugfixes are
easiest submitted as `pull request on Bitbucket
<https://confluence.atlassian.com/display/BITBUCKET/Work+with+pull+requests>`_.