comfort-array

Arrays where the index type is a function of the shape type

http://hub.darcs.net/thielema/comfort-array/

Version on this page:0.4
LTS Haskell 23.0:0.5.5
Stackage Nightly 2024-12-13:0.5.5
Latest on Hackage:0.5.5

See all snapshots comfort-array appears in

BSD-3-Clause licensed and maintained by Henning Thielemann
This version can be pinned in stack with:comfort-array-0.4@sha256:9ea3f9aa7951fe69a005bf561b5aa3f57cb56bf739c7a032d968cdef0f95f766,4361

Arrays from the basic array package are already very powerful compared with arrays in other languages. They may have any number of dimensions, are type safe and defined in a uniform way using the Ix class with free choice of the lower bounds (0, 1, or whatever you like).

This package goes one step further: The shape and the index type are different, but the index type is a type function of the shape type. This offers much more flexibility and type safety.

Some examples are:

  • Range: Allow dynamic choice of lower and upper array bounds such as in the Arrays from the array package. You can combine it with other shapes in other dimensions. It allows you to describe the bounds of each dimension individually.

  • Shifted: Describe array bounds by start index and length. It is sometimes more natural to use these parameters. E.g. a non-negative index type like Word cannot represent -1 and thus cannot encode an empty range starting with index 0.

  • ZeroBased, OneBased: Arrays with fixed lower bound, either 0 or 1, respectively.

  • Zero, (): Arrays with fixed size 0 or 1, respectively.

  • Enumeration: Arrays with indices like LT, EQ, GT and a shape of fixed size.

  • (:+:): The Append type constructor allows to respresent block arrays, e.g. block matrices. It also allows to represent non-empty arrays via ():+:sh.

  • Set: Use an arbitrary ordered set as index set.

  • Triangular: A 2D array with the shape of a lower or upper triangular matrix.

  • Tagged: Statically distinguish shapes and indices that are isomorphic.

The lapack package defines even more fancy shapes like tall rectangular matrices, triangular matrices and banded matrices.

Changes

Change log for the comfort-array package

0.4

  • fromAssocations: Make default value the first parameter. It is most oftenly zero and thus less variable than the array size.

  • Shape.DeferredIndex: Now uses the shape as the type parameter, not the index type.

0.3

  • Storable.Mutable.Array: Replace ForeignPtr by Array.Guarded.MutablePtr. In the last release we altered the arrays after initialization which corrupted the debugging by the guarded-allocation package. This should be fixed now.

  • Shape.sizeOffset: It does not return a single offset anymore but an offset computation function. This allows to cache a size computation across many offset computations.

0.2

  • Add a monad parameter to the mutable Storable array type and generalize functions to PrimMonads. This way the mutating functions can also be used in the ST monad.

0.1.2

  • Add immutable Boxed array type and mutable Storable array type.

0.1

  • Split Shape.C into Shape.C and Shape.Indexed.

0.0

  • Initial version featuring the Shape.C class with type function Index and the immutable Storable array type.