Skip to content

Commit 07a793f

Browse files
committed
update readme
1 parent 9e39e06 commit 07a793f

File tree

1 file changed

+17
-42
lines changed

1 file changed

+17
-42
lines changed

README.md

Lines changed: 17 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -24,61 +24,36 @@ potentials and functions defined on chunkers
2424
compressed inverse preconditioning (RCIP) scheme for effectively
2525
treating problems with corners and multiple junctions.
2626

27+
Detailed documentation is being built [here](https://chunkie.readthedocs.io/en/latest/)
28+
2729
## Installing chunkIE
2830

29-
Clone the repository with the submodules
31+
For other install options, see [the documentation.](https://chunkie.readthedocs.io/en/latest/getchunkie.html)
32+
33+
To compile from git, clone the repository with the submodules
3034

3135
git clone --recurse-submodules https://github.com/fastalgorithms/chunkie.git
3236

3337
and run startup.m in the install directory.
3438
This will download the FLAM and fmm2d submodules, include FLAM in
3539
the matlab path, and generate the fmm2d mex file if a fortran compiler
36-
exists.
40+
exists.
41+
42+
For troubleshooting suggestions, see [the documentation](https://chunkie.readthedocs.io/en/latest/getchunkie.html)
3743

3844
## Using chunkIE
3945

40-
Check out the chunkie/demo folder.
46+
Check out the chunkie/demo folder or the [guide (under construction)](https://chunkie.readthedocs.io/en/latest/guide.html)
4147

4248
## License
4349

44-
chunkIE is copyright 2019 the chunkIE team
50+
chunkIE is copyright 2024 the chunkIE team
4551

4652
chunkIE proper (the contents of the chunkie
4753
folder) is available under the terms of the
4854
BSD 3-clause license, which should have been included
4955
in the distribution (see chunkie/LICENSE.md)
5056

51-
## Installation notes
52-
53-
- The fmm2d mex installation is currently not supported on Windows, to
54-
complete the mex installation, follow instructions on the [fmm2d documentation](https://fmm2d.readthedocs.io/en/latest/install.html)
55-
- fmm2d mex installation depends on gfortran. In case a compiler is not
56-
found, the installation will be skipped. To install dependencies follow the procedure below based on your OS
57-
58-
* MacOS
59-
60-
Get xcode, command line tools by running
61-
62-
xcode-select --install
63-
64-
Then install Homebrew from https://brew.sh, and finally install gfortran using
65-
66-
brew install gcc
67-
68-
* Ubuntu linux
69-
70-
sudo apt-get install make build-essential gfortran
71-
72-
* Fedora/centOS linux
73-
74-
sudo yum install make gcc gcc-c++ gcc-gfortran libgomp
75-
76-
- If installing without submodules, chunkIE depends on [FLAM](https://github.com/klho/FLAM),
77-
and optionally on the
78-
[fmm2d](https://github.com/flatironinstitute/fmm2d) repository. Parts of
79-
the library will not function without FLAM and its subdirectories included in the matlab path.
80-
81-
8257
## chunkIE team
8358

8459
chunkIE has benefitted from the contributions of several developers: Travis Askham,
@@ -89,19 +64,19 @@ James Bremer and Zydrunas Gimbutas provided generalized Gaussian quadrature rule
8964

9065
Many routines were modelled after parts of the legeexps.f library (Copyright Vladimir Rokhlin, Free BSD 3-clause),
9166
FMMLIB2D (Copyright Leslie Greengard and Zydrunas Gimbutas, Free BSD 3-clause), and Johan Helsing's
92-
RCIP tutorial (https://arxiv.org/abs/1207.6737)
67+
[RCIP tutorial](https://arxiv.org/abs/1207.6737)
9368

9469
## Citing this software
9570

9671
If you found this software useful, we ask that you please cite the following
9772
works
9873

99-
- [This software] see CITATIONS.cff for details
100-
- [The fast multipole method library] https://github.com/flatironinstitute/fmm2d
101-
- [The fast direct solver library] Ho, Kenneth L. "FLAM: Fast linear algebra in MATLAB-Algorithms for hierarchical matrices." Journal of Open Source Software 5.51 (2020): 1906.
102-
- [Quadrature generation routines] Bremer, James, Zydrunas Gimbutas, and Vladimir Rokhlin. "A nonlinear optimization procedure for generalized Gaussian quadratures." SIAM Journal on Scientific Computing 32.4 (2010): 1761-1788.
103-
- [Corner and multiple junction handling] Helsing, Johan. "Solving integral equations on piecewise smooth boundaries using the RCIP method: a tutorial." Abstract and applied analysis. Vol. 2013. Hindawi, 2013.
104-
- [Fast multipole method paper] Greengard, Leslie, and Vladimir Rokhlin. "A fast algorithm for particle simulations." Journal of computational physics 73.2 (1987): 325-348.
74+
- {This software} see CITATIONS.cff for details
75+
- {The fast multipole method library} https://github.com/flatironinstitute/fmm2d
76+
- {The fast direct solver library} Ho, Kenneth L. "FLAM: Fast linear algebra in MATLAB-Algorithms for hierarchical matrices." Journal of Open Source Software 5.51 (2020): 1906.
77+
- {Quadrature generation routines} Bremer, James, Zydrunas Gimbutas, and Vladimir Rokhlin. "A nonlinear optimization procedure for generalized Gaussian quadratures." SIAM Journal on Scientific Computing 32.4 (2010): 1761-1788.
78+
- {Corner and multiple junction handling} Helsing, Johan. "Solving integral equations on piecewise smooth boundaries using the RCIP method: a tutorial." Abstract and applied analysis. Vol. 2013. Hindawi, 2013.
79+
- {Fast multipole method paper} Greengard, Leslie, and Vladimir Rokhlin. "A fast algorithm for particle simulations." Journal of computational physics 73.2 (1987): 325-348.
10580

10681
## Contributing
10782

0 commit comments

Comments
 (0)