summaryrefslogtreecommitdiff
blob: 361f919bab1153d66c41132a5132a87f0c4c523e (plain)
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
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE pkgmetadata SYSTEM "https://www.gentoo.org/dtd/metadata.dtd">
<pkgmetadata>
	<maintainer type="project">
		<email>haskell@gentoo.org</email>
		<name>Gentoo Haskell</name>
	</maintainer>
	<longdescription>
		Unboxed multidimensional bit packed Bool arrays with fast aggregate
		operations based on lifting Bool operations to bitwise operations.
		
		There are many other bit packed structures out there, but none met
		all of these requirements:
		
		(1) unboxed bit packed Bool array,
		
		(2) multi-dimensional indexing,
		
		(3) fast (de)serialization, or interoperable with foreign code,
		
		(4) fast aggregate operations (fold, map, zip).
		
		Quick tour of the bitwise library:
		
		[Data.Bits.Bitwise] Lift boolean operations on 'Bool' to bitwise
		operations on 'Data.Bits.Bits'.
		
		[Data.Array.BitArray] Immutable bit arrays.
		
		[Data.Array.BitArray.ST] Mutable bit arrays in 'Control.Monad.ST.ST'.
		
		[Data.Array.BitArray.IO] Mutable bit arrays in 'IO'.
		
		[Data.Array.BitArray.ByteString] (De)serialization.
		
		[Codec.Image.PBM] Portable bitmap monochrome 2D image format.
		
		Very rough performance benchmarks:
		
		* immutable random access single bit reads:
		@BitArray ix@ is about 40% slower than @UArray ix Bool@,
		
		* 'Control.Monad.ST.ST' mutable random access single bit reads:
		@STBitArray s ix@ is about the same as @STUArray s ix Bool@,
		
		* immutable map @Bool -&gt; Bool@:
		@BitArray ix@ is about 85x faster than @UArray ix Bool@,
		
		* immutable zipWith @Bool -&gt; Bool -&gt; Bool@:
		@BitArray ix@ is about 1300x faster than @UArray ix Bool@.
	</longdescription>
</pkgmetadata>