| 1 | = Bindings for the GNU Scientific Library = |
---|
| 2 | |
---|
| 3 | (c) Daniel Truemper |
---|
| 4 | |
---|
| 5 | License: [source:trunk/gsl/LICENSE GPL] |
---|
| 6 | |
---|
| 7 | = 1. Disclaimer = |
---|
| 8 | |
---|
| 9 | These bindings have only been tested in a Debian/Linux (x32) environment using |
---|
| 10 | gdc. If you have successfully run them on Windows or Mac or whatever, simply |
---|
| 11 | contact me and I'll add appropriate comments to this file; or you might change |
---|
| 12 | this file on your own and submit it via SVN. |
---|
| 13 | |
---|
| 14 | |
---|
| 15 | |
---|
| 16 | = 2. Remarks = |
---|
| 17 | |
---|
| 18 | This version really is beta! If you want to or are using these bindings and |
---|
| 19 | experience erros and have fixed them, feel free to add them either directly |
---|
| 20 | via SVN to the [http://www.dsource.org/projects/bindings bindings project] or you might find me in #d or #d.tango on |
---|
| 21 | freenode or post in the forums. Of corse you can also contact me via email. |
---|
| 22 | |
---|
| 23 | Since I am currently writing my diploma thesis I might not have the time to |
---|
| 24 | really test _all_ functions so there really might be errors... |
---|
| 25 | |
---|
| 26 | |
---|
| 27 | |
---|
| 28 | = 3. Download = |
---|
| 29 | |
---|
| 30 | The best way of downloading the bindings is to checkout the Subversion |
---|
| 31 | repository of the bindings project. Another way is to download the |
---|
| 32 | autogenerated zip file: [http://www.dsource.org/projects/bindings/changeset/head/trunk/gsl?old_path=%2F&format=zip gsl.zip] |
---|
| 33 | |
---|
| 34 | |
---|
| 35 | |
---|
| 36 | = 4. Build & Install = |
---|
| 37 | |
---|
| 38 | I built this library with the help of [http://www.dsource.org/projects/dsss dsss] a really great tool you should |
---|
| 39 | consider using, if you are not by now. Writing Makefiles is obsolete with it. |
---|
| 40 | If you have dsss installed you simply type in the main directory |
---|
| 41 | |
---|
| 42 | $ dsss build |
---|
| 43 | |
---|
| 44 | In order to install the library correctly just type |
---|
| 45 | |
---|
| 46 | $ dsss install |
---|
| 47 | |
---|
| 48 | If you (one day) do not need the library anymore just uninstall it using |
---|
| 49 | |
---|
| 50 | $ dsss uninstall gsl |
---|
| 51 | |
---|
| 52 | |
---|
| 53 | |
---|
| 54 | = 5. Testing = |
---|
| 55 | |
---|
| 56 | I have added the first basic testing routines to the test directory. Again |
---|
| 57 | there is a dsss.conf file allowing you to build the testing program on your |
---|
| 58 | own: |
---|
| 59 | |
---|
| 60 | $ dsss build |
---|
| 61 | |
---|
| 62 | and then run |
---|
| 63 | |
---|
| 64 | $ ./testgsl |
---|
| 65 | |
---|
| 66 | If you want to help me do the testing, simply add routines to the |
---|
| 67 | "test/test/main.d" file. It's a bit annoying for the moment but I couldn't |
---|
| 68 | find a more less usefull testing environment for now, it will probably change |
---|
| 69 | in the future. |
---|
| 70 | |
---|
| 71 | |
---|
| 72 | |
---|
| 73 | = 6. Using the library = |
---|
| 74 | |
---|
| 75 | If you simply want to use the library with your own program and have |
---|
| 76 | successfully installed the library with dsss, add the following line to your |
---|
| 77 | dsss.conf file: |
---|
| 78 | |
---|
| 79 | buildflags = -L-lgsl -L-lblas |
---|
| 80 | |
---|
| 81 | Of corse you need the real libraries installed on your machine. On Debian |
---|
| 82 | based systems search for libgsl and libblas. |
---|
| 83 | |
---|
| 84 | If you have done this, you should be able to simply add import statements |
---|
| 85 | similar to the "#include <gsl/gsl_*.h>" statements from the documentation. |
---|
| 86 | You only have to change the import from "gsl/*" to "gsl.*" ommiting the ".h" |
---|
| 87 | in the end. |