//
// Math.NET Numerics, part of the Math.NET Project
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
//
// Copyright (c) 2009-2020 Math.NET
//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
// restriction, including without limitation the rights to use,
// copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
// OTHER DEALINGS IN THE SOFTWARE.
//
using System;
namespace IStation.Numerics.Providers.SparseSolver
{
public static class SparseSolverControl
{
const string EnvVarSSProvider = "MathNetNumericsSSProvider";
const string EnvVarSSProviderPath = "MathNetNumericsSSProviderPath";
static ISparseSolverProvider _sparseSolverProvider;
static readonly object StaticLock = new object();
///
/// Gets or sets the sparse solver provider. Consider to use UseNativeMKL or UseManaged instead.
///
/// The linear algebra provider.
public static ISparseSolverProvider Provider
{
get
{
if (_sparseSolverProvider == null)
{
lock (StaticLock)
{
if (_sparseSolverProvider == null)
{
UseDefault();
}
}
}
return _sparseSolverProvider;
}
set
{
value.InitializeVerify();
// only actually set if verification did not throw
_sparseSolverProvider = value;
}
}
///
/// Optional path to try to load native provider binaries from.
/// If not set, Numerics will fall back to the environment variable
/// `MathNetNumericsSSProviderPath` or the default probing paths.
///
public static string HintPath { get; set; }
public static ISparseSolverProvider CreateManaged()
{
return new Managed.ManagedSparseSolverProvider();
}
public static void UseManaged()
{
Provider = CreateManaged();
}
#if NATIVE
public static ISparseSolverProvider CreateNativeMKL()
{
return new Mkl.MklSparseSolverProvider(GetCombinedHintPath());
}
public static void UseNativeMKL()
{
Provider = CreateNativeMKL();
}
public static bool TryUseNativeMKL()
{
return TryUse(CreateNativeMKL());
}
///
/// Try to use a native provider, if available.
///
public static bool TryUseNative()
{
if (AppSwitches.DisableNativeProviders || AppSwitches.DisableNativeProviderProbing)
{
return false;
}
return TryUseNativeMKL();
}
#endif
static bool TryUse(ISparseSolverProvider provider)
{
try
{
if (!provider.IsAvailable())
{
return false;
}
Provider = provider;
return true;
}
catch
{
// intentionally swallow exceptions here - use the explicit variants if you're interested in why
return false;
}
}
///
/// Use the best provider available.
///
public static void UseBest()
{
if (AppSwitches.DisableNativeProviders || AppSwitches.DisableNativeProviderProbing)
{
UseManaged();
return;
}
#if NATIVE
if (!TryUseNative())
{
UseManaged();
}
#else
UseManaged();
#endif
}
///
/// Use a specific provider if configured, e.g. using the
/// "MathNetNumericsDSSProvider" environment variable,
/// or fall back to the best provider.
///
public static void UseDefault()
{
if (AppSwitches.DisableNativeProviders)
{
UseManaged();
return;
}
#if NATIVE
var value = Environment.GetEnvironmentVariable(EnvVarSSProvider);
switch (value != null ? value.ToUpperInvariant() : string.Empty)
{
case "MKL":
UseNativeMKL();
break;
default:
UseBest();
break;
}
#else
UseBest();
#endif
}
public static void FreeResources()
{
Provider.FreeResources();
}
static string GetCombinedHintPath()
{
if (!String.IsNullOrEmpty(HintPath))
{
return HintPath;
}
var value = Environment.GetEnvironmentVariable(EnvVarSSProviderPath);
if (!String.IsNullOrEmpty(value))
{
return value;
}
return null;
}
}
}