O método get_bus_v_pu_ang_pandas já retorna todas as barras, tensões e ângulos.

Neste contexto, faz sentido a existência dos métodos abaixo?

• get_all_bus_names
• get_bus_v_pu_ang_pandas

Algumas funções estão com os nomes fora de padrão.
Deve-se ajusta-las

When a .dss file with a "MakePosSeq" command is performed a IndexError on line.tools.get_all_infos.

Report:
[...]
File "~ /.venv/lib/python3.8/site-packages/dssdata/_formatters.py", line 30, in __get_mag_vanish
return tuple(map(func_aux, range(0, 3)))
File "~ /.venv/lib/python3.8/site-packages/dssdata/_formatters.py", line 15, in __aux_vanish
return mag_or_ang[list_ph.index(indx + 1)]
IndexError: tuple index out of range

Criação de testes automatizados para o losses_tools.py

O Fluxo de potência temporal precisa ser implementado a partir do fluxo de potência estático.

Até o momento está definido que cada resolução do passo de tempo será organizado em um Pandas.DataFrame, da mesma forma que o fluxo de potência estático, com uma coluna indicando o passo de tempo no qual foi executado.

Deve-se definir quais métodos serão criados, por exemplo, retorno de tensão e ângulo, perdas das linhas?

• Create all losses tools
• Create Tests
• Documentation

This project uses MkDocs for documentation with the following extensions:

• Material for MkDocs;
• mkdocstrings;
• mkdocs-jupyter;

To simulate the documentation make sure that all these packages are installed.

You can easily get all the development environment using Poetry.

$ git clone https://github.com/felipemarkson/dssdata.git
$ cd dssdata
$ poetry install
$ poetry shell

The file requiriments.txt does not have the development packages.

After installing all packages, you can run:

$ mkdocs serve

By default, the documentation is built in http://127.0.0.1:8000 on a development server.

You can edit any file from /docs or/and edit the functions docstrings in python files.

Como chamar a funcionalidade?

Precisa ser definido se a funcionalidade será um método ou um atributo do sistema. Eu acredito que pode ser um método.

Estrutura de dados?

Futuramente será implementado a funcionalidade de time-series. A funcionalidade deve ter uma estrutura de dados que possamos, no futuro, incluir no padrão DataFrame.

https://github.com/dss-extensions/OpenDSSDirect.py/releases/tag/v0.8.1

• Documentar as funções com docstrings do Python. Veja Exemplo;
• Criação de uma documentação mais acessível, talvez utilizando Mkdocstrings;
• Hospedagem da documentação no Github Pages;
• Traduzir toda a documentação atual para inglês.

Com a criação da base de execução. torna-se necessário inserir novos componentes no sistema, como Storage e Generators.

Hello,

1. I am trying to use the Time series Power Flow, however, no matter what values I give loadmult, the voltage values remains the same. (for example for loadmult=[0,0.5,1] I get 3 identical values of voltages at all of the loads) (the code appears below)
2. Is there an option to get the values of P,Q at each load (like voltages.get_all for voltage values)?
3. Is it possible to identify different loadmult to different loads?

Thank you!

the code:
distSys = SystemClass(path=path, kV=[115, 4.16, 0.48], loadmult=[0,0.5,1])
cfg_tspf(distSys, step_size="1h", initial_time=(0, 0))
[voltageDataFrame] = run_tspf(distSys, tools=[voltages.get_all], num_steps=3)

Acrescentar funções e/ou agregar mais sobre as perdas relacionadas as componentes do tipo PD ao losses_tool.py. Por enquanto são apresentadas as perdas totais de todos os elementos do tipo PD, é interessante apresentar a contribuição de cada elemento para a composição dessa perda total.

Obs: Os capacitores aparecem como um elemento PD, mas durante o cálculo das perdas totais do circuito não são levados em cosideração.

All links on Getting Started page is not working.

I created this Issue to discuss a good example of time series power flow to include in the tutorial.

I wrote a quick example in Issue #80, but it needs more details of the differences with the static power flow.

Needs create an issue that teaches how to build the documentation.

The Learning DSSData page doesn't show how to deal with Tools with other arguments.

Deve-se definir quais informações serão disponibilizadas neste método.

Acredito que:

• Nome da linha
• Barras as quais ela interliga
• Corrente que passa em cada fase da linha;
• Valor máximo de carregamento;
• Porcentagem de carregamento da linha;
• Perdas da linha

The Learning DSSData Page uses Python Notebooks, but it's not looking good.

As reported in #90 the SystemClass has some troubles when the DSS File has multi-line comments.

This could be solved using a function that vanishes the DSS content before save in SystemClass._dsscontent. This must be done without changing the DSS file.

A classe PowerFlow está se tornando extramente grande e muitas outras funcionalidades ainda precisam ser implementadas.

Talvez dividir a classe PowerFlow em:

• Uma classe possuem apenas informações do sistema que não precisam ser calculadas, chamada DistSys. Esta abordagem facilitaria na inclusão de outras classes, como BESS, DG que podem ser englobadas em outra Classe geral de montagem.

• Classe geral chamada PowerFlow que "monta" o sistema para assim poder gerar as informações do fluxo de potência estático.

Funcionalidade de retorno de perdas

Como chamar a funcionalidade?

Precisa ser definido se a funcionalidade será um método ou um atributo do sistema. Eu acredito que pode ser um método.

Estrutura de dados?

Futuramente será implementado a funcionalidade de time-series. A funcionalidade deve ter uma estrutura de dados que possamos, no futuro, incluir no padrão DataFrame.

Quais informações terão no retorno da funcionalidade?

O OpendssDirect possui os métodos :

• Circuit.LineLosses() : Este método retorna as perdas de todas as linhas.
• Circuit.Losses(): Este método retorna as perdas de todas as linhas com as perdas de outros dispositivos, como DG e Storage e etc...

Qual utilizar? englobar perdas de outros dispositivos?

A partir do Pull Request #30 está definido que as fases das linhas devem ser conectadas na ordem no arquivo OpenDSS, ou seja "bus1 = bus.2.3", não podendo ser "bus1= bus.3.2".

Este problema inviabiliza sistemas de distribuição com transposição (pouco comum).

The Documentation pages doesn't link properly.

Após o PR #35 foi decidido que cada PC element terá seu próprio tool.
Parecido com o que é feito no line_tools.py.

Questionamentos:

• Quais dados cada elemento terá em seu tools? (Tensão, corrent, perdas... etc)

• Como mostrar as características únicas de cada PC element. Ex. O Storage possui kwhrated.

The SystemClass cannot process a .dss file that has multiline comments.

Ex:

\* 
multiline comments
multiline comments
*/

On loadmult Description.

https://felipemarkson.github.io/dssdata/api/#dssdata.SystemClass.__init__

When the system is big (greater than 1000 nodes) or there is many steps in TS Power Flow (one year on 15min step) the run_tspf or run_pf may present performance issues.

Maybe concated Dataframe just on final of Power Flow can fix it.

Inicial documentação dos tools de perdas.

Devido ao Bug reportado em #49, surgiu a necessidade de criação de CI para sistemas operacionais diferentes.

Foi identificado um bug durante os testes em sistemas operacionais diferentes.

O bug ocorre no OpenDSSDirect.py e foi reportado na issue #82.

Após a solução do bug, deverá ser criado testes automatizados em sistemas operacionais diferentes neste projeto.

Desenvolvimento do método para obtenção de informações de tensão em cada barra do sistema.

How the project is organized

The SystemClass has only the responsibility to process the .dss file.

The Power flow modes has only the responsibility to configure and run a power flow mode with Actions and Tools.

The Actions has only the responsibility to change the distribution system state temporarily.

The Tools has only the responsibility to get data information from the current state of the distribution system.

The Reduction has only the responsibility to transform various tool's returns in a DataFrame.

See the package documentation for more details

The dependence manager and development environment

We use Poetry to manage the dependencies.

You can quickly get all the development environment run the following commands:

$ git clone https://github.com/felipemarkson/dssdata.git
$ cd dssdata
$ poetry install
$ poetry shell

Make sure that you have installed the Python version required.

Linting

Flake8 in default configuration.

Documentation

We use Google's Style Guide for docstrings documentation.

All public functions must be documented at last with docstrings.

You can see more details to how to simulate the documentation on #72.

Tests and CI

We use the unittest for our functional tests. We know that it is not the best choice, but it works fine.

If you have other suggestions on how to build our tests, please tell us in an Issue.

It is necessary to change the functions that use OpenDSSDirect.py by the equivalent of dss_python.