All rights reserved.

Redistribution and use in source and binary forms, with or without

- The APIs, mostly notably the class organization and logic sequences of the COM API. These are used to further automate the DSS engine, extract data and integrate to third party software. The current APIs all follow the concept of "active object" that may be new for many users.

- The official COM DLL is available only for Microsoft Windows ([COM is a Microsoft technology](https://en.wikipedia.org/wiki/Component_Object_Model)), while DSS Sharp tries to reproduce the same API without depending on specific platforms — we can use Windows, Linux, or macOS, even on ARM processors.

Com exceção de gráficos e outros componentes visuais, este projeto expõe a maioria das funcionalidades implementadas na DSS C-API, incluindo algumas otimizações de desempenho, suporte a executar scripts .DSS dentro de arquivos ZIP, suporte inicial a exportação JSON, compatibilidade multiplataforma (Linux, Windows, macOS), includindo Intel x86/x64 e ARM.

Ao contrário da implementação oficial, DSS Sharp suporta a criação de múltiplas instâncias independentes do motor do OpenDSS ([`dss_sharp.DSS.NewContext()`](https://dss-extensions.org/dss_sharp/html/d0e4d400-3bd9-1244-3cac-8f1234cbad9f.htm)), efetivamente permitindo que o usuário empregue aplicações com múltiplos threads de forma mais efetiva. A maioria das funções da versão PM do OpenDSS também estão [disponíveis](https://dss-extensions.org/dss_sharp/html/f3440753-3e74-bdb2-81c6-9052f8742d7e.htm).

<p align="center">

<img alt="Visão geral dos repositórios" src="https://raw.githubusercontent.com/dss-extensions/dss_capi/master/docs/images/repomap.png" width=600>

- As interfaces de programação (APIs), em especial a organização de classes e lógica empregada na API COM. As interfaces são usadas para automatizar ainda mais o uso do motor do DSS, extrair dados e integrar programas e bibliotecas de terceiros. As APIs atuais todas seguem o conceito de "objeto ativo" ("Active...") que pode ser novo para muitos usuários.

- O DLL do módulo COM oficial está disponível apenas no Microsoft Windows ([COM é uma tecnologia da Microsoft](https://pt.wikipedia.org/wiki/Component_Object_Model)). DSS Sharp tenta reproduzir a mesma interface em nível do usuário sem depender de plataformas específicas — podemos usar Windows, Linux, or macOS, mesmo em processadores ARM.

<PackageReadmeFile>README.md</PackageReadmeFile>

<NoWarn>1591</NoWarn>

<PlatformTarget>x64</PlatformTarget>

<PackageVersion>0.13.1</PackageVersion>

<Title>DSS Sharp</Title>

<Description>

Extra features include support for .DSS scripts in ZIP files, creation of multiple DSS instances in the same process (including user-controlled multi-threading), and an extended API for various components.

</Description>

<PackageId>dss_sharp</PackageId>

<license>BSD-3-Clause AND LGPL</license>

is the ability to get numeric data directly for different scenarios according to the analysis the user is required to achieve.

For example, suppose you wanted to compare the voltages for two scenarios of load.

When we set `engine.Error.EarlyAbort = false` on dss_sharp, you will get the same behavior.

is to stop the execution on the first error found. As such, we don't inhibit errors in automated/unattended

large scale simulations.

{

/// <summary>

/// The DSS_CAPI static class exposes DSS C-API functions to C#.

/// (customized, not supported by EPRI, etc.) OpenDSS engine and wraps

/// it in easily consumable C-compatible functions.

///

// dss_sharp: A compatibility layer for DSS C-API that mimics the official OpenDSS COM interface.

// Copyright (c) 2016-2023 Paulo Meira

//

// See LICENSE for more information.

//

/// If enabled, don't check for NaNs in the inner solution loop.

/// This can lead to various errors.

/// This flag is useful for legacy applications that don't handle OpenDSS API errors properly.

/// </summary>

NoSolverFloatChecks = 0x00000001,

/// <summary>

/// {True | False*} Designates whether to allow duplicate names of objects

///

/// release since it has performance impacts even when not used.

/// </summary>

public bool AllowDuplicates

/// <summary>

/// If enabled, the `DOScmd` command is allowed. Otherwise, an error is reported if the user tries to use it.

///

///

/// This can also be set through the environment variable DSS_CAPI_ALLOW_DOSCMD. Setting it to 1 enables

/// the command.

///

/// - NoSolverFloatChecks = 0x1 (bit 0): If enabled, don't check for NaNs in the inner solution loop. This can lead to various errors.

/// This flag is useful for legacy applications that don't handle OpenDSS API errors properly. Through the

///

/// - BadPrecision = 0x2 (bit 1): Toggle worse precision for certain aspects of the engine. For example,

/// the sequence-to-phase (`As2p`) and sequence-to-phase (`Ap2s`) transform matrices. On DSS C-API,

/// <summary>

/// APIUtil provides some common functions to read data and map errors.

/// </summary>

public class APIUtil

{