# mathed 0.1.0

Small math library for D

To use this package, run the following command in your project's root directory:

Manual usage
Put the following dependency into your project's dependences section:

## mathed

This is a small math library written in D Programming Language.

### Features:

#### Matrix and vector

1. All actions is checked at compile time. There are no exceptions.
2. Matrix and vector structure contains only it's data, and nothing additional.
3. Almost all actions is `nothrow` and `@safe`

#### Matirx usage

1. Creating matrix
2. Matrix can be:
3. added: `m + m`.
4. subtracted: `m - m`.
5. multiplied by number: `m * 2`.
6. divided by number: `m / 2`.
7. multiplied by another matrix: `m * m`.
8. transposed: `m.t`.
9. iterated by element number:
10. iterated by line and column numbers:
11. set in one action:
12. If you need to check type of some variable to be a matrix, use `isMatrix`
``````    // Creating matrix
auto m = Matrix!(int, 3, 3)
(
3, -1, 6,
2,  1, 5,
-3,  1, 0
);
assert (m[0][2] == 6);

// Iteration by element number
foreach (i, ref col; m)
{
writefln ("The %s-th element of matrix is %s", i, col);
}

// iteration by line and column numbers:
foreach (i, j, ref col; m)
{
writefln ("The element of %s-th line, %s-th column of matrix is %s", i, j, col);
}

// Setting all matrix values in one action
m.set
(
3, -1, 6,
2,  1, 5,
-3,  1, 0
);

// Type checking
bool check = isMatrix!(typeof (m));
``````

#### Vector usage

1. Vector can have accessor - a named property method returning one of vector element. Accessor can be two types:
2. One-letter accessor:
3. Multiletter accessor. Accessor delimiter in the accessors string should be `|` or `,`.
4. Vector has the same actions as matrix, with some differences:
5. Vector could not be iterated by line and column numbers (`#8`).
6. Vector can be converted to matrix. Matrix type (one-lined or one-columned) depends on VectorType (`horizontal` and `vertical`). By default all vectors are `horizontal`.
7. If you need to check type of some variable to be a vector, use `isVector`.
``````    // Creating simple vector
auto vec = Vector!(int, 2)(10, 20);
assert (vec[0] == 10);

// Vector accessor (one-letter)
auto vec = Vector!(int, 2, "xy")(10, 20);
assert (vec.x == 10);

// Vector accessor (multiletter)
auto vec = Vector!(int, 2, "col|row")(10, 20);
assert (vec.col == 10);

// Convertion vector to matrix
auto vec = Vector!(int, 2, "col|row")(10, 20);
vec.toMatrix ();
assert (isMatrix!(typeof (vec)));
``````

#### Current version

alpha: by now it provides only matrix and vector implementation.

Authors:
Dependencies:
none
Versions:
 0.2.0 2014-Oct-20 0.1.0 2014-Aug-04 ~master 2014-Oct-21