Repository files navigation

Experimenting (again) with constrained categories, as well as Haskell to hardware, automatic differentiation, interval analysis, and other interpretations. See the paperCompiling to categories.

You will need to haveGraphViz installed, with itsdot command on your execution path.

To run miscellaneous examples:

stack build :misc-examples

There are several more commented-out examples in examples/test/Examples.hs.You can fiddle with comments to change the collection of examples compiled.That module also serves as an example to copy and make your own examples.

For the graphics examples, instead run

stack build :graphics-examples

There are more examples in graphics/test/Examples.hs.

Note: as of 2018-08-30, the graphics examples work under GHC 8.0.2 and 8.2.2 but not later, because of dependency on language-glsl.(Seethis issue.)

The SMT examples are disabled by default, because they rely on installing theZ3 SMT solver (with installation etc describedhere).To enable some of those examples, install Z3, uncomment them in examples/test/Examples.hs, and run as follows:

stack build :misc-examples --flag concat-examples:smt

If you tweak the source and want to make a pull request, please also run the gold tests:

stack build :gold-tests

Sometimes the generated categorical expressions change with GHC versions while preserving semantics. In such cases, it might be unclear whether something broke or not.

InstallGraphViz.

https://github.com/ku-fpg/netlist is the repo that includes the offending package.To get things started dogit clone https://github.com/ku-fpg/netlist.git ../netlist-kit-kufp/

The plugin works via two kinds of rewrite rules: some specified viaRULES pragmas, in the modulesConCat.AltCat andConCat.Rebox, and a "builtin" rule, which is Haskell code that explicitly manipulates Core, inConCat.Plugin. An run-time error of the form "Oops: toCcc' called" occurs if the plugin was not able to transform away all uses of the pseudo-functiontoCcc' (which has no implementation) via the rules.

Therefore:

• Be sure to import theConCat.AltCat andConCat.Rebox modules, e.g.,

importConCat.AltCat ()importConCat.Rebox ()

• Remember to tell ghc to use the plugin with the option-fplugin=ConCat.Plugin.

• Remember to turn on optimization, which enables the firing of the rules (e.g.,-O or-O2).

• Sometimes you also need to importGHC.Generics with a few constructors exposed (e.g.,U1,Par1,(:*:), andComp1) so that Core casts can be successfully translated to categorical form (viaCoercible).This requirement is especially unfortunate because the need to import has nothing to do with explicit use of those constructors in code that you write, and because following this advice leads to compiler warnings about unused imports.I hope to find an alternative method of translating coercions.

Example of ghc compilation:

ghc -O -fplugin=ConCat.Plugin YourModule.hs

Unfortunately, this library doesn't (yet) work when called from ghci.

You can get more info about plugin failures by providing some flags in the module being compiled with the plugin.The current options:

{-#OPTIONS_GHC -fplugin-opt=ConCat.Plugin:trace #-}{-#OPTIONS_GHC -fplugin-opt=ConCat.Plugin:showResiduals #-}{-#OPTIONS_GHC -fplugin-opt=ConCat.Plugin:showCcc #-}

• trace: Generatelots of output as (small) transformations happen.
• showResiduals: AresidualtoCcc' call is one that the plugin did not manage to eliminate.Since thetoCcc' pseudo-function has no implementation, residuals often result in a run-time error message.
• showCcc: Show the Core for the whole module being compiled, at the end of thetoCcc phase and before the final GHC passes.

Working:

• Circuit graphs
• Automatic differentiation
• GLSL for graphics
• Interval analysis
• Incremental computation
• SMT (satisfy modulo theories), with John Wiegley

In progress:

• Polynomials
• Demand analysis for strictness.
• Functions with some special cases like constant, linear, polynomial, as well as the general case

Others:

• Something about language recognition, such as regular languages
• Various semirings, including shortest/longest paths
• Probabilistic programming and other wrappings of monadic interfaces
• Memoization at every stage. With what benefit?
• AFRP