11![ Herbie] ( logo.png )
22
3- Herbie synthesizes floating-point programs from real-number programs,
4- automatically handling simple numerical instabilities.
5- Visit [ our website] ( https://herbie.uwplse.org ) for tutorials,
6- documentation, and an online demo.
7-
8- Current Status
9- --------------
103
114[ ![ Build Status] ( https://travis-ci.org/uwplse/herbie.svg?branch=master )] ( https://travis-ci.org/uwplse/herbie )
125
13- Herbie can improve the accuracy of many real-world programs, and is
14- used by scientists in many disciplines. It has lead to two patches
15- (for
16- complex [ square roots] ( https://github.com/josdejong/mathjs/pull/208 )
17- and
18- [ trigonometric functions] ( https://github.com/josdejong/mathjs/pull/247 ) ),
19- in [ math.js] ( http://mathjs.org/ ) an open-source mathematics library.
20- Herbie has semi-regular releases twice a year, maintains backwards
21- compatibility, and uses standardized formats.
22-
23- Helping Out
24- -----------
25-
26- Herbie development is organized on our
27- [ mailing list] ( https://mailman.cs.washington.edu/mailman/listinfo/herbie )
28- where we discuss work in progress and announce major improvements.
29- [ Email us
] ( mailto:[email protected] ) to get involved!
30-
31- We use [ Github] ( https://github.com/uwplse/herbie )
32- and [ Trello] ( https://trello.com/b/lh7b33Dr/herbie ) to organize some
33- development goals Our test results
34- are [ archived] ( http://herbie.uwplse.org/reports/ ) .
6+ Herbie synthesizes floating-point programs from real-number programs,
7+ automatically handling simple numerical instabilities. Visit [ our
8+ website] ( https://herbie.uwplse.org ) for tutorials, documentation, and
9+ an online demo. Herbie has semi-regular releases twice a year,
10+ maintains backwards compatibility, and uses standardized formats.
3511
3612Installing
3713----------
3814
3915For full details on installing Herbie, please see the
40- [ tutorial] ( http://herbie.uwplse.org/doc/latest/installing-herbie .html ) .
16+ [ tutorial] ( http://herbie.uwplse.org/doc/latest/installing.html ) .
4117
42- Herbie requires Racket 6.3 or later, and supports Linux and OS X.
43- Install it with:
18+ Herbie requires Racket 6.7 or later, and supports Windows, OS X, and
19+ Linux. Install it with:
4420
4521 raco pkg install herbie
4622
@@ -66,9 +42,10 @@ Run Herbie from the top-level directory of the repo, and enter the
6642cancellation test:
6743
6844 $ herbie shell
69- Seed: #(1046809171 2544984934 1871826185 4237421819 4093186437 162666889)
45+ Herbie 1.2 with seed #(349461420 3681359142 2680361770 2900531005 1939065059 1779362427)
46+ Find help on <https://herbie.uwplse.org/>, exit with Ctrl-D
7047 herbie> (FPCore (x) (- (+ 1 x) x))
71- (FPCore (x) 1)
48+ (FPCore (x) ... 1)
7249
7350The output is Herbie's improved, more-accurate expression, in this case
7451the constant ` 1 ` .
@@ -79,6 +56,18 @@ Consult the
7956[ documentation] ( http://herbie.uwplse.org/doc/latest/options.html ) .
8057for more.
8158
59+ Helping Out
60+ -----------
61+
62+ Herbie development is organized on our
63+ [ mailing list] ( https://mailman.cs.washington.edu/mailman/listinfo/herbie )
64+ where we discuss work in progress and announce major improvements.
65+ [ Email us
] ( mailto:[email protected] ) to get involved!
66+
67+ We use [ Github] ( https://github.com/uwplse/herbie )
68+ and [ Trello] ( https://trello.com/b/lh7b33Dr/herbie ) to organize some
69+ development goals.
70+
8271Running Tests
8372-------------
8473
@@ -92,17 +81,15 @@ projects, examples emailed to the developers, and from numerical
9281analysis textbooks. This suite is found in ` bench/ ` . The full test can
9382be run with
9483
95- herbie report bench/
84+ herbie report bench/ graphs/
9685
97- This full test can take several hours to run. We often test Herbie on
98- basic but representative examples with:
86+ The output is an HTML report in ` graphs/ ` . This full test can take
87+ several hours to run. We often test Herbie on basic but representative
88+ examples with:
9989
100- herbie report bench/hamming/
90+ herbie report bench/hamming/ graphs/
10191
10292This takes approximately 15 minutes.
10393
104- Test results are collected on
105- [ uwplse.org] ( http://herbie.uwplse.org/reports/ ) . If you have an
106- account on this server, you can publish your test results with
107-
108- make publish
94+ Historic and nightly test results are collected on
95+ [ uwplse.org] ( http://herbie.uwplse.org/reports/ ) .
0 commit comments