Skip to content

Commit 9fcf7ac

Browse files
committed
Update docs for 0.14.2
1 parent 07e6eae commit 9fcf7ac

File tree

3 files changed

+15
-8
lines changed

3 files changed

+15
-8
lines changed

README.md

+5-3
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77

88
Please see [FAQ](https://github.com/dss-extensions/dss-extensions#faq) for a couple of notes.
99

10-
This library exposes the OpenDSS/OpenDSS-PM v9+ engine in a plain C interface that tries to reproduce most of the COM methods, plus many extensions. In fact, most of the code was initially derived from the COM implementation files. The resulting DLL can be using directly by advanced users or, for example, through the `dss_python` module in Python, a module that mimics the COM structure (as exposed via `win32com` or `comtypes`), effectively enabling multi-platform compatibility at Python level.
10+
This library exposes the OpenDSS/OpenDSS-PM v9+ engine in a plain C interface that tries to reproduce most of the COM methods, plus many extensions. In fact, most of the code was initially derived from the COM implementation files. The resulting DLL can be using directly by advanced users or, for example, through the `DSS-Python` package in Python, a module that mimics the COM structure (as exposed via `win32com` or `comtypes`), effectively enabling multi-platform compatibility at Python level.
1111

1212
Through the other projects under DSS-Extensions, DSS C-API enables projects to use the OpenDSS in multiple platforms (Windows, Linux, macOS) across multiple architectures (Intel x86, x86-64, ARM32, and ARM64, including Apple's M1 and M2). Most of the features added to this based library is shared across all other projects. If you need support for a language not listed below, please open a new issue (either here or in https://github.com/dss-extensions/dss-extensions/issues) and we will evaluate that language.
1313

@@ -17,11 +17,12 @@ Through the other projects under DSS-Extensions, DSS C-API enables projects to u
1717

1818
If you are looking for the bindings to other languages:
1919

20-
- [DSS-Python](http://github.com/dss-extensions/dss_python/) is a multi-platform Python module (Windows, Linux, MacOS) very compatible with the original COM DLL. See also [OpenDSSDirect.py](http://github.com/dss-extensions/OpenDSSDirect.py/) if you don't need COM compatibility, or just would like to check its extra functionalities (you can mix DSS-Python and OpenDSSDirect.py).
20+
- [DSS-Python](http://github.com/dss-extensions/DSS-Python/) is a multi-platform Python module (Windows, Linux, MacOS) very compatible with the original COM DLL. See also [OpenDSSDirect.py](http://github.com/dss-extensions/OpenDSSDirect.py/) if you don't need COM compatibility, or just would like to check its extra functionalities (you can mix DSS-Python and OpenDSSDirect.py).
2121
- [OpenDSSDirect.jl](http://github.com/dss-extensions/OpenDSSDirect.jl/) is a Julia module, created by Tom Short (@tshort), migrated with the help of Dheepak Krishnamurthy (@kdheepak) to DSS C-API instead of the DDLL in Feb 2019.
2222
- [DSS Sharp](http://github.com/dss-extensions/dss_sharp/) is available for .NET/C#, [packaged on NuGet](https://www.nuget.org/packages/dss_sharp/), also mimics the COM classes (drop-in replacement for `OpenDSSengine.DLL`). The current version is now multi-platform too! Soon it will be possible to use it via COM.
2323
- [DSS MATLAB](http://github.com/dss-extensions/dss_matlab/) presents multi-platform integration (Windows, Linux, MacOS) with DSS C-API and is also very compatible with the API of the official OpenDSS COM classes.
24-
- [dss.hpp](https://dss-extensions.org/dss_capi/): header-only library for C++, also hosped in this repository (`include/` directory). Allows using DSS C-API more comfortably from C++, abstract away memory management and low-level details such as API conventions of the DSS C-API library. Currently uses Eigen and fmt.
24+
- [dss.hpp](https://dss-extensions.org/dss_capi/): header-only library for C++, also hosted in this repository (`include/` directory). Allows using DSS C-API more comfortably from C++, abstract away memory management and low-level details such as API conventions of the DSS C-API library. Currently uses Eigen and fmt.
25+
- New projects in 2024 include [AltDSS-Python](http://dss-extensions.org/AltDSS-Python/) (where we are testing the new API, [AltDSS-Go](https://github.com/dss-extensions/AltDSS-Go/) and [AltDSS-Rust](https://github.com/dss-extensions/AltDSS-Rust/).
2526

2627
Version 0.14.x is based on OpenDSS revision 3723 (exactly OpenDSS v9.8.0.1), with many extra/custom features.
2728

@@ -46,6 +47,7 @@ Since 2019-03-05, the `dss_capi` repository contains all the Pascal code used to
4647

4748
See [the changelog](https://github.com/dss-extensions/dss_capi/blob/master/docs/changelog.md) for a detailed list.
4849

50+
- 2024-02-26 / version 0.14.2: More incremental updates and fixes, especially in the alternative API.
4951
- 2024-02-16 / version 0.14.1: Incremental updates and fixes, especially in the alternative API.
5052
- 2024-02-09 / version 0.14.0: Lots of changes and bugfixes, see the changelog.
5153
- 2023-06-27 / version 0.13.4: Bugfix release (CapControl), incremental improvements. See the changelog or release page for details.

README.pt-BR.md

+7-4
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33

44
*For an English version of this file, see [README.md](https://github.com/dss-extensions/dss_capi/blob/master/README.md).*
55

6-
# DSS C-API: Uma biblioteca com interface C para uma implementação Alternativa do OpenDSS
6+
# AltDSS/DSS C-API: Uma biblioteca com interface C para uma implementação Alternativa do OpenDSS
77

88
Veja [FAQ](https://github.com/dss-extensions/dss-extensions#faq) (em inglês) para algumas notas.
99

@@ -22,8 +22,9 @@ Caso procure integração com outras linguagens de programação:
2222
- [DSS Sharp](http://github.com/dss-extensions/dss_sharp/) para .NET/C#, disponível também [como pacote NuGet](https://www.nuget.org/packages/dss_sharp/). Versões mais recentes são multi-plataforma! Em breve também será possível usá-lo via COM.
2323
- [DSS MATLAB](http://github.com/dss-extensions/dss_matlab/) permite integração multi-plataforma (Windows, Linux, MacOS) bastante compatível com a API do módulo COM oficial, de fato contorna algumas dificuldades de COM.
2424
- [dss.hpp](https://dss-extensions.org/dss_capi/): biblioteca de headers para C++, hospedada também neste repositório (pasta `include/`). Permite usar a DSS C-API de forma confortável sem ser necessário gerenciar os detalhes como o gerenciamento de memória ou convenção de API da DSS C-API. Atualmente usa Eigen e fmt.
25+
- Novos projetos em 2024 incluem [AltDSS-Python](http://dss-extensions.org/AltDSS-Python/) (onde está sendo testada a API alternativa), [AltDSS-Go](https://github.com/dss-extensions/AltDSS-Go/) e [AltDSS-Rust](https://github.com/dss-extensions/AltDSS-Rust/).
2526

26-
A versão 0.13.x é baseada no OpenDSS revisão (SVN) 3619 (OpenDSS v9.6.1.2), com várias funcionalidades customizadas e extras.
27+
A versão 0.14.x é baseada no OpenDSS revisão (SVN) 3723 (OpenDSS v9.8.0.1), com várias funcionalidades customizadas e extras.
2728

2829
**Este branch pode estar em desenvolvimento. Para uma versão específica, consulte os tags do Git do repositório.**
2930

@@ -46,8 +47,10 @@ A partir de 2019-03-05, este repositório contém todo o código fonte em lingua
4647

4748
Veja o [registro de alterações (em inglês)](https://github.com/dss-extensions/dss_capi/blob/master/docs/changelog.md) para listagem detalhada.
4849

49-
- **2023-06-27 / version 0.13.4: Correção de bugs (CapControl), melhorias incrementais.**
50-
- 2023-06-11 / version 0.13.3: Correção de bugs em alguns dos componentes (em especial Capacitor, Reactor, UPFC).
50+
- 2024-02-26 / versão 0.14.2: Mais correções e atualizações incrementais, especialmente na API alternativa.
51+
- 2024-02-16 / versão 0.14.1: Correções e atualizações incrementais, especialmente na API alternativa.
52+
- 2023-06-27 / versão 0.13.4: Correção de bugs (CapControl), melhorias incrementais.
53+
- 2023-06-11 / versão 0.13.3: Correção de bugs em alguns dos componentes (em especial Capacitor, Reactor, UPFC).
5154
- 2023-05-24 / versão 0.13.2: Melhorias para exportação JSON, verificação de erros, refatoração do código interno, e port de algumas mudanças menores do OpenDSS oficial.
5255
- 2023-04-01 / versão 0.13.1: Traz apenas algumas potenciais correções relacionadas a 3 propriedades de PVSystem
5356
- 2023-03-29 / versão 0.13.0: Várias melhorias, incluindo correção de bugs e portes de várias modificações do OpenDSS oficial; a referência para esta versão é o OpenDSS v9.6.1.1.

docs/changelog.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,9 @@
1717

1818
# Versions 0.14.x
1919

20-
## Version 0.14.2 (to be released)
20+
## Version 0.14.2 (2024-02-26)
21+
22+
Minor release to address issues found in the Alt API. Besides `Lines_Get_Parent`, the other changes do not affect behavior of the classic API functions.
2123

2224
- Alt/Bus: fix Lines/Loads/PCElements/PDElements when multiple elements are present
2325
- Alt/CE: Fix `Alt_CE_Get_RegisterValues` in the C header.

0 commit comments

Comments
 (0)