If you do not want to use the official binaries, or if you like to modify, debug or contribute, you can compile locally either using Visual Studio or manually with the build scripts.
We clearly separate dependency management from the IDE and therefore recommend to
restore.sh once after every git checkout in order to restore
the dependencies exactly as defined. Otherwise Visual Studio and other IDEs
may fail to compile or provide correct IntelliSense.
Tests can be run with the usual integrated NUnit test runners or ReSharper.
Instead of a compatible IDE you can also build the solutions directly with
the .NET Core SDK build tools. You may need to run
before, once after every git checkout in order to restore the dependencies.
restore.cmd (or ./restore.sh) dotnet build MathNet.Numerics.sln
The fully automated build including unit tests, documentation and api reference, NuGet and Zip packages is using FAKE.
FAKE itself is not included in the repository but it will download and bootstrap itself automatically when build.cmd is run the first time. Note that this step is not required when using Visual Studio or the .NET Core SDK directly.
./build.sh # normal build and unit tests, when using bash shell on Windows or Linux. build.cmd # normal build and unit tests, when using Windows CMD shell. ./build.sh build # normal build ./build.sh build strongname # normal build and also build strong-named variant ./build.sh test # normal build, run unit tests ./build.sh test quick # normal build, run unit tests except long running ones ./build.sh clean # cleanup build artifacts ./build.sh docs # generate documentation ./build.sh api # generate api reference ./build.sh all # build, test, docs, api reference
We manage NuGet and other dependencies with Paket. You do not normally have to do anything with Paket as it is integrated into our FAKE build tools, unless you want to actively manage the dependencies.
.paket/paket.exe restore will restore the packages
to the exact version specified in the
.paket/paket.exe install will install or migrate packages after you have
made changes to the
will show whether any packages are out of date and
will update all packages within the defined constraints. Have a look at the Paket
website for more commands and details.
This website and documentation is automatically generated from of a set of
CommonMark structured files in
The final documentation can be built by calling
However, for editing and previewing the docs on your local machine it is more
convenient to run
build.sh DocsWatch in a separate console instead, which
monitors the content files and incrementally regenerates the HTML output
automatically. DocsWatch will also use local/relative URIs instead of absolute
ones, so that the links and styles will work as expected locally. This can
also be enabled in a full one-time build with
build.sh DocsDev instead
While only maintainers can make official releases published on NuGet and referred to from the website, you can use the same tools to make your own releases for your own purposes.
Versioning is controlled by the release notes. Before building a new version,
first add a new release header and change notes on top of the
document in the root directory. The fake builds pick this up and propagate it
to the assembly info files automatically.
The build can then be launched by calling:
The build script will print the current version as part of the the header banner, which is also included in the release notes document in the build artifacts. Example:
// __ __ _ _ _ _ ______ _______ // | \/ | | | | | | \ | | ____|__ __| // | \ / | __ _| |_| |__ | \| | |__ | | // | |\/| |/ _` | __| '_ \ | . ` | __| | | // | | | | (_| | |_| | | |_| |\ | |____ | | // |_| |_|\__,_|\__|_| |_(_)_| \_|______| |_| // // Math.NET Numerics - https://numerics.mathdotnet.com // Copyright (c) Math.NET - Open Source MIT/X11 License // // Math.NET Numerics v3.5.0 // Math.NET Numerics MKL Provider v1.7.0 // Math.NET Numerics Data Extensions v3.1.0
The artifacts are then ready in the
In addition to the core package this repository also include extra packages like the data extensions. Most build targets are available for these packages as well, with the following prefixes:
Datafor the Data Extensions
Building the Intel MKL native provider for Windows requires additionally:
The build can then be triggered by calling:
./build.sh MklWinBuild // build both 32 and 64 bit variants ./build.sh MklTest // run all tests with the MKL provider enforced ./build.sh MklWinAll // build and run tests
If you run into an error with
mkl_link_tool.exe you may need to patch a targets file,
see MKL 2020.1, VS2019 linking bug .
The build puts the binaries to
x86), the NuGet package
out/MKL/NuGet and a Zip archive to
out/MKL/Zip. You can directly use the provider from
there by setting
Control.NativeProviderPath to the full path pointing to
this is also what the unit tests do when you run the
MklTest build target.
RELEASENOTES.md file with relevant changes, attributed by contributor (if external). Set date.
CONTRIBUTORS.md file (via
git shortlog -sn)
build.sh all --strongname
build.sh PublishDocs build.sh PublishApi build.sh PublishTag build.sh PublishArchive build.sh PublishNuGet
Consider a tweet via @MathDotNet