Brahma.FSharp 2.0.6

.NET 7.0 This package targets .NET 7.0. The package is compatible with this framework or higher.
There is a newer prerelease version of this package available.
See the version list below for details. 
dotnet add package Brahma.FSharp --version 2.0.6
                    


                    

                
NuGet\Install-Package Brahma.FSharp -Version 2.0.6
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="Brahma.FSharp" Version="2.0.6" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Brahma.FSharp" Version="2.0.6" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Brahma.FSharp" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Brahma.FSharp --version 2.0.6
                    


                    

                
#r "nuget: Brahma.FSharp, 2.0.6"
#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. 
#:package Brahma.FSharp@2.0.6
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Brahma.FSharp&version=2.0.6
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Brahma.FSharp&version=2.0.6
                    


                            Install as a Cake Tool

Brahma.FSharp

FAKE Build NuGet Badge NuGet Badge License

Brahma.FSharp provides a way to utilize GPGPU in your F# programs. It is based on F# quotations to OpenCL translation.

Features

  • Utilization of OpenCL for communication with GPU. So, you can work not only with NVIDIA devices but with any device which supports OpenCL (e.g. with AMD or Intel devices).
  • Not only primitive types, but also discriminated unions, structs, records are supported.
  • Pattern matching, mutable and immutable bindings, nested bindings are supported.
  • Custom atomics.
  • Fine-grained memory management and kernels compilation process.
  • Mailbox processor based interface for communication with devices.

More details are available here.

Installation

Install Brahma.FSharp by running:

dotnet add package Brahma.FSharp

Setup BRAHMA_OCL_PATH environment variable to opencl.dll location if it differs from default.

Quick Start

open Brahma.FSharp

let device = ClDevice.GetFirstAppropriateDevice()
let context = RuntimeContext(device)

let kernel =
    <@
        fun (range: Range1D) (buffer: int clarray) ->
            let gid = range.GlobalID0
            buffer.[gid] <- buffer.[gid] + 1
    @>

opencl {
    use! buffer = ClArray.alloc<int> 1024
    do! runCommand kernel <| fun kernel ->
        kernel
        <| Range1D(1024, 256)
        <| buffer

    return! ClArray.toHost buffer
}
|> ClTask.runSync context

Contributing

Contributions, issues and feature requests are welcome. Feel free to check issues page if you want to contribute.

Build

Make sure the following requirements are installed on your system:

  • dotnet SDK 7.0 or higher
  • OpenCL-compatible device and respective OpenCL driver

To build and run all tests:

  • on Windows
build.cmd
  • on Linux/macOS
./build.sh

To find more options look at MiniScaffold. We use it in our project.

Relese

The release process is automated: NuGet packages publishing process is triggered by tag pushing to any branch. To release new vesion one should

  1. Add relese notes to CHANGELOG
  2. Run ./build.sh Release [version] (on local machine)

License

This project licensed under EPL-1.0 License. License text can be found in the license file.

Product Compatible and additional computed target framework versions.
.NET 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 was computed.  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.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Brahma.FSharp:

Package Downloads
Brahman.Substrings

Brahman is a set of snippets, algorithms and solution for end users based on Brahma.FSharp. Brahman.Substrings is a library for substrings matching."
Brahma.FSharp.OpenCL.WorkflowBuilder

Brahma.FSharp does the thing!

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.0.0-alpha1.5 210 4/17/2024
3.0.0-alpha1.3 85 4/12/2024
3.0.0-alpha1.2 75 4/12/2024
3.0.0-alpha1.1 77 4/9/2024
2.0.6 202 3/28/2025
2.0.5 2,166 2/10/2023
2.0.4 411 1/13/2023
2.0.3 571 1/4/2023
2.0.2 358 12/28/2022
2.0.1 3,238 8/5/2022
2.0.0 545 7/5/2022
2.0.0-alpha9.6 248 6/3/2022
2.0.0-alpha9.5 200 5/7/2022
2.0.0-alpha9.4 208 4/8/2022
2.0.0-alpha9.3 204 3/24/2022
2.0.0-alpha9.2 1,415 11/26/2021
2.0.0-alpha9.1 379 10/16/2021
2.0.0-alpha9 318 10/15/2021
2.0.0-alpha8 315 9/27/2021
2.0.0-alpha7.1 244 7/18/2021
2.0.0-alpha7 383 5/19/2021
2.0.0-alpha6.2 290 5/19/2021
2.0.0-alpha6.1 337 3/22/2021
2.0.0-alpha6 326 3/22/2021
2.0.0-alpha5 482 1/27/2021
2.0.0-alpha4 450 12/27/2020
2.0.0-alpha3 409 11/27/2020
2.0.0-alpha2 510 11/11/2020
1.1.5 1,753 11/10/2017
1.1.4 1,173 11/2/2017
1.1.3 1,287 7/16/2017
1.1.2 1,271 7/5/2017
1.1.1 1,239 7/5/2017
1.1.0 1,237 6/21/2017
1.1.0-alpha4 1,008 5/30/2017
1.1.0-alpha3 1,075 5/9/2017
1.1.0-alpha2 993 5/9/2017
1.1.0-alpha1 1,123 5/6/2017
1.0.1 2,078 7/15/2016
1.0.0 1,431 7/14/2016
0.3.5 2,130 6/27/2014
0.3.0.1 1,427 6/18/2014
0.2.4 2,395 3/28/2014
0.2.3 1,532 3/14/2014
0.2.2 1,521 3/11/2014
0.2.0 2,986 12/2/2013
0.1.4992 1,546 9/2/2013
0.1.4989 1,501 8/30/2013
0.1.4926 2,519 6/28/2013
0.0.0.3 1,652 6/28/2013
0.0.0.2 1,623 5/31/2013
0.0.0.1 1,581 5/30/2013

## [2.0.6] - 2025-03-26

[2.0.6]: https://github.com/YaccConstructor/Brahma.FSharp/compare/v2.0.6...v2.0.6

### Added
- Thread-local array allocation.