matrix2d

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #typescript #machine-learning #macos #windows #awesome #vue #awesome-list #pytorch #openai #mcp #open-source

(★ 14)

A package for mathematical 2D array functions and manipulations in Dart, similar to NumPy

matrix2d Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Matrix 2D 🧮

[![pub version](https://img.shields.io/pub/v/matrix2d.svg)](https://pub.dev/packages/matrix2d)
[![Build Status](https://github.com/n4ze3m/matrix2d/actions/workflows/ci.yml/badge.svg)](https://github.com/n4ze3m/matrix2d/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/github/license/n4ze3m/matrix2d)](https://github.com/n4ze3m/matrix2d/blob/master/LICENSE)

With Matrix 2D, you can perform matrix operations such as addition, subtraction, and multiplication in Dart. It is a simple and easy-to-use library inspired by Python's NumPy library.

## Operations

- `addition(listA,listB)` returns array of sums of corresponding elements of listA and listB of any dimensions.

- `subtraction(listA,listB)` returns array of differences of corresponding elements of listA and listB of any dimensions.

- `division(listA,listB)` divides listA by listB and returns new array

- `dot(listA,listB)` Function returns the dot product of two arrays. For 2-D vectors, it is the equivalent to matrix multiplication. For 1-D arrays, it is the inner product of the vectors. For N-dimensional arrays, it is a sum product over the last axis of a and the second-last axis of b.

- `shape(list)` returns dimensions of input array if the array is uniform or error otherwise.

- `flatten(list)` returns 1-D representation of any shape and any levels of nesting of list array.

- `transpose(list)` Reverse the axes of an array and returns the modified array

- `arange(start, stop, steps)` returns evenly spaced values within the half-open interval `[start, stop)` with optional steps argument.

- `zeros(row,cols)` Return a new array of given shape and type, with zeros

- `ones(row,cols)` Return a new array of given shape and type, with ones

- `sum(list)` Function returns the sum of array elements

- `reshape(list)`Reshaping means changing the shape of an array.

- `diagonal(list)` To find a diagonal element from a given matrix and gives output as one dimensional matrix.
- `fill(row,cols,object)` Just like `zeros()` and `ones` this function will return a new array of given shape, with given object(anything btw strings too)

* `compareobject(list,operation,obj)` compare values inside an array with given object and operations. function will return a new boolen array (this function is deprecated in favor of `compare`)

* `concatenate(listA,listB,{axis})` Concatenation refers to joining. This function is used to join two arrays of the same shape along a specified axis. The function takes the following parameters.Axis along which arrays have to be joined. Default is 0

* `min(list,{axis})` Functions, used to find the minimum value for any given array

* `max(list,{axis})` Functions, used to find the maximum value for any given array

* `slice(list (List<List>), row_index [start, stop*], column_index [start, stop*]*)` Function used to slice two-dimensional arrays . (_column_index_ and _stop_ not required )

* `reverse(list,{axis})` Function used to reverse the array along the given axis. The function takes the following parameters.Axis along which the array is to be flipped. Default is 0

## Examples

<h2>shape</h2>

```dart
List list = [[1, 2],[1, 2]];
print(list.shape);
```

<b>ouput</b>:

```cmd
[2,2]
```

<hr>

<h2>flatten</h2>

```dart
List list = [[1, 2],[1, 2]];
print(list.flatten);
```

<b>ouput</b>:

```cmd
[1,2,1,2]
```

<hr>
<h2>transpose</h2>

```dart
List list = [[1, 2],[1, 2]];
print(list.transpose);
```

<b>ouput</b>:

```cmd
[[1,1],[2,2]]
```

<hr>
<h2>addition</h2>

```dart
List list1 = [[1, 1],[1, 1]];
List list2 = [[2, 2],[2, 2]];
var addition = m2d.addition(list1,list2);
print(addition);
```

<b>ouput</b>:

```cmd
[[3,3],[3,3]]
```

<hr>
<h2>subtraction</h2>

```dart
List list1 = [[1, 1],[1, 1]];
List list2 = [[2, 2],[2, 2]];
var subtraction = m2d.subtraction(list1,list2);
print(subtraction);
```

<b>ouput</b>:

```cmd
[[-1,-1],[-1,-1]]
```

<hr>
<h2>division</h2>

```dart
List list1 = [[1, 1],[1, 1]];
List list2 = [[2, 2],[0, 2]];
var division = m2d.subtraction(division,list2);
print(division);
```

<b>ouput</b>:

```cmd
[[0.5,Infinity],[0.5,0.5]]
```

<hr>
<h2>dot operation</h2>

```dart
List list1 = [[1,2],[3,4]];
List list2 = [[11,12],[13,14]];
var dot = m2d.dot(division,list2);
print(dot);
```

<b>ouput</b>:

```cmd
[[37, 40], [85, 92]]
```

<hr>
<h2>arange</h2>

```dart
var arange = m2d.arange(8);
print(arange);
```

<b>ouput</b>:

```cmd
[[0,1,2,3,4,5,6,7,8]]
```

<hr>

```dart
var list = [[2,2],[2,2]];
var sum = m2d.sum(list);
print(sum);
```

<b>ouput</b>:

```cmd
8
```

<hr>
<h2>reshape</h2>

```dart
List list = [[0, 1, 2, 3, 4, 5, 6, 7]];
list = list.reshape(2,4);
print(list);
```

<b>ouput</b>:

```cmd
[[0, 1, 2, 3], [4, 5, 6, 7]]
```

<hr>
<h2>linspace</h2>

```dart
var linspace = m2d.linspace(2, 3, 5);
print(linspace);
```

<b>ouput</b>:

```cmd
[2.0, 2.25, 2.5, 2.75, 3.0]
```

<hr>
<h2>diagonal</h2>

```dart
List list = [[1,1,1],[2,2,2],[3,3,3]];
print(list.diagonal);
```

<b>ouput</b>:

```cmd
[1,2,3]
```

<hr>
<h2>compare</h2>

```dart
var list = [[1,1,1],[2,2,2],[3,3,3]];
var compare = m2d.compare(list,'>',2);
print(compare);
```

<b>ouput</b>:

```cmd
[[false, false, false], [false, false, false], [true, true, true]]
```

<hr>
<h2>concatenate</h2>

```dart
final l1 = [
    [1, 1, 1],
    [1, 1, 1],
    [1, 1, 1]
  ];
  final l2 = [
    [0, 0, 0],
    [0, 0, 0],
    [0, 0, 0],
    [0, 0, 0],
  ];
  final l3 = m2d.concatenate(l1, l2);
  print(l3);
```

<b>ouput</b>:

```cmd
[[1, 1, 1],
[1, 1, 1],
[1, 1, 1],
[0, 0, 0],
[0, 0, 0],
[0, 0, 0],
[0, 0, 0]]
```

```dart
final a1 = [
    [1, 1, 1, 1],
    [1, 1, 1, 1],
    [1, 1, 1, 1]
  ];
  final a2 = [
    [0, 0, 0, 0, 0,0, 0, 0, 0, 0],
    [0, 0, 0, 0, 0,0, 0, 0, 0, 0],
    [0, 0, 0, 0, 0,0, 0, 0, 0, 0]
  ];

final a3 = m2d.concatenate(a2, a1, axis: 1);
  print(a3);
```

<b>ouput</b>:

```cmd
[[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1],
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1],
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1]]
```

<hr>
<h2>zeros,ones and fill</h2>

```dart
var zeros = m2d.zeros(2,2);
print(zeros);

var ones = m2d.ones(2,2);
print(ones);

var anything = m2d.fill(2,2,'i love dart');
print(anything);
```

<b>ouput</b>:

```cmd
[[0,0],[1,1]]

[[1,1],[1,1]]

[['i love dart','i love dart'],['i love dart','i love dart']]
```

<hr>

```dart
 final numbers = [
    [1, 2, 3],
    [4, 5, 6],
    [7, 8, 9]
  ];
  print(numbers.min());
  print(numbers.min(axis: 1));
  print(numbers.min(axis: 0));
  print(numbers.max());
  print(numbers.max(axis: 1));
  print(numbers.max(axis: 0));
```

<b>ouput</b>:

```cmd
[1]

[1, 4, 7]

[1, 2, 3]

[9]

[3, 6, 9]

[7, 8, 9]
```

<h2>slice</h2>

```dart

var sliceArray = [
    [1, 2, 3, 4, 5],
    [6, 7, 8, 9, 10]
  ];

var newArray = m2d.slice(sliceArray, [0, 2], [1, 4]);
  print(newArray);

```

<b>ouput</b>:

```cmd
[[2, 3, 4],[7, 8, 9]]
```

## Contribution

If you want to contribute to this project, you are always welcome! Just make a pull request and I will review it as soon as possible.

## Features and bugs

If you have any problems or suggestions, please open an issue [here](https://github.com/n4ze3m/matrix2d/issues).

matrix2d

matrix2d Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

matrix2d

matrix2d Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README