System.Numerics.Tensors 8.0.0

Prefix Reserved
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package System.Numerics.Tensors --version 8.0.0                
NuGet\Install-Package System.Numerics.Tensors -Version 8.0.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="System.Numerics.Tensors" Version="8.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add System.Numerics.Tensors --version 8.0.0                
#r "nuget: System.Numerics.Tensors, 8.0.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install System.Numerics.Tensors as a Cake Addin
#addin nuget:?package=System.Numerics.Tensors&version=8.0.0

// Install System.Numerics.Tensors as a Cake Tool
#tool nuget:?package=System.Numerics.Tensors&version=8.0.0                

About

Provides methods for performing mathematical operations over tensors represented as spans. These methods are accelerated to use SIMD (Single instruction, multiple data) operations supported by the CPU where available.

Key Features

  • Numerical operations on tensors represented as ReadOnlySpan<float>
  • Element-wise arithmetic: Add, Subtract, Multiply, Divide, Exp, Log, Cosh, Tanh, etc.
  • Tensor arithmetic: CosineSimilarity, Distance, Dot, Normalize, Softmax, Sigmoid, etc.

How to Use

using System.Numerics.Tensors;

var movies = new[] {
    new { Title="The Lion King", Embedding= new [] { 0.10022575f, -0.23998135f } },
    new { Title="Inception", Embedding= new [] { 0.10327095f, 0.2563685f } },
    new { Title="Toy Story", Embedding= new [] { 0.095857024f, -0.201278f } },
    new { Title="Pulp Function", Embedding= new [] { 0.106827796f, 0.21676421f } },
    new { Title="Shrek", Embedding= new [] { 0.09568083f, -0.21177962f } }
};
var queryEmbedding = new[] { 0.12217915f, -0.034832448f };

var top3MoviesTensorPrimitives =
    movies
        .Select(movie =>
            (
                movie.Title,
                Similarity: TensorPrimitives.CosineSimilarity(queryEmbedding, movie.Embedding)
            ))
        .OrderByDescending(movies => movies.Similarity)
        .Take(3);

foreach (var movie in top3MoviesTensorPrimitives)
{
    Console.WriteLine(movie);
}

Main Types

The main types provided by this library are:

  • System.Numerics.Tensors.TensorPrimitives

Additional Documentation

Feedback & Contributing

System.Numerics.Tensors is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (27)

Showing the top 5 NuGet packages that depend on System.Numerics.Tensors:

Package Downloads
Microsoft.ML.CpuMath

Microsoft.ML.CpuMath contains optimized math routines for ML.NET.

Microsoft.Data.Analysis

This package contains easy-to-use and high-performance libraries for data analysis and transformation.

Microsoft.SemanticKernel.Core

Semantic Kernel core orchestration, runtime and functions. This package is automatically installed by 'Microsoft.SemanticKernel' package with other useful packages. Install this package manually only if you are selecting individual Semantic Kernel components.

ppy.osu.Framework

A 2D application/game framework written with rhythm games in mind.

Microsoft.KernelMemory.Abstractions

Kernel Memory is a Copilot/Semantic Kernel Plugin and Memory Web Service to index and query any data and documents, using LLM and natural language, tracking sources and showing citations. The package contains the interfaces and models shared by all Kernel Memory packages.

GitHub repositories (18)

Showing the top 5 popular GitHub repositories that depend on System.Numerics.Tensors:

Repository Stars
microsoft/semantic-kernel
Integrate cutting-edge LLM technology quickly and easily into your apps
dotnet/machinelearning
ML.NET is an open source and cross-platform machine learning framework for .NET.
SciSharp/LLamaSharp
A C#/.NET library to run LLM (🦙LLaMA/LLaVA) on your local device efficiently.
ppy/osu-framework
A game framework written with osu! in mind.
microsoft/kernel-memory
RAG architecture: index and query any data using LLM and natural language, track sources, show citations, asynchronous memory patterns.
Version Downloads Last updated
9.0.0-rc.2.24473.5 8,917 10/8/2024
9.0.0-rc.1.24431.7 9,718 9/10/2024
9.0.0-preview.7.24405.7 1,526 8/13/2024
9.0.0-preview.6.24327.7 1,766 7/9/2024
9.0.0-preview.5.24306.7 1,832 6/11/2024
9.0.0-preview.4.24266.19 417 5/21/2024
9.0.0-preview.3.24172.9 435 4/11/2024
9.0.0-preview.2.24128.5 340 3/12/2024
9.0.0-preview.1.24080.9 469 2/13/2024
8.0.0 2,015,437 11/14/2023
8.0.0-rc.2.23479.6 211,484 10/10/2023
8.0.0-rc.1.23419.4 181 9/12/2023
8.0.0-preview.7.23375.6 229 8/8/2023
8.0.0-preview.6.23329.7 219 7/11/2023
8.0.0-preview.5.23280.8 223 6/13/2023
8.0.0-preview.4.23259.5 175 5/16/2023
8.0.0-preview.3.23174.8 622 4/11/2023
8.0.0-preview.2.23128.3 229 3/14/2023
8.0.0-preview.1.23110.8 188 2/21/2023
7.0.0-rtm.22518.5 11,094 11/7/2022
7.0.0-rc.2.22472.3 721 10/11/2022
7.0.0-rc.1.22426.10 374 9/14/2022
7.0.0-preview.7.22375.6 236 8/9/2022
7.0.0-preview.6.22324.4 292 7/12/2022
7.0.0-preview.5.22301.12 215 6/14/2022
7.0.0-preview.4.22229.4 262 5/10/2022
7.0.0-preview.3.22175.4 253 4/13/2022
7.0.0-preview.2.22152.2 220 3/14/2022
7.0.0-preview.1.22076.8 205 2/17/2022
6.0.0-rtm.21522.10 2,402 11/8/2021
6.0.0-rc.2.21480.5 3,395 10/12/2021
6.0.0-rc.1.21451.13 205 9/14/2021
6.0.0-preview.7.21377.19 258 8/10/2021
6.0.0-preview.6.21352.12 231 7/14/2021
6.0.0-preview.5.21301.5 229 6/15/2021
6.0.0-preview.4.21253.7 208 5/24/2021
6.0.0-preview.3.21201.4 306 4/8/2021
6.0.0-preview.2.21154.6 267 3/11/2021
6.0.0-preview.1.21102.12 214 2/12/2021
5.0.0-preview.8.20407.11 733 8/25/2020
5.0.0-preview.7.20364.11 310 7/21/2020
5.0.0-preview.6.20305.6 350 6/25/2020
5.0.0-preview.5.20278.1 307 6/10/2020
5.0.0-preview.4.20251.6 353 5/18/2020
5.0.0-preview.3.20214.6 310 4/23/2020
5.0.0-preview.2.20160.6 397 4/2/2020
5.0.0-preview.1.20120.5 344 3/16/2020
0.2.0-preview7.19362.9 540 7/23/2019
0.2.0-preview6.19303.8 395 6/12/2019
0.2.0-preview6.19264.9 336 9/4/2019
0.2.0-preview5.19224.8 385 5/6/2019
0.2.0-preview4.19212.13 380 4/18/2019
0.2.0-preview3.19128.7 446 3/6/2019
0.2.0-preview.19073.11 425 1/29/2019
0.2.0-preview.18571.3 556 12/3/2018
0.1.0 1,552,045 11/14/2018