// // 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; } } }