bdgd2opendss is a powerful tool designed to facilitate the integration and analysis of distribution systems in OpenDSS. It builds on core functionalities initially developed in the bdgd-tools project, extending them with new features focused on improving conversion efficiency and accuracy. In addition to its technical benefits, bdgd2opendss serves an important educational purpose, aimed at democratizing Brazilian distribution system modeling by making real Brazilian distribution system models accessible to students and researchers.
bdgd2opendss is responsible solely for converting models from bdgd format to OpenDSS format. It is not intended to verify or validate any data contained in bdgd.
bdgd2opendss was created to continue and evolve the work from the bdgd-tools project with a clearer focus on performing only the conversion from bdgd to OpenDSS. While bdgd-tools provided a solid foundation, the decision to create a new repository stems from several key reasons:
- Streamlined Focus: bdgd2opendss narrows its focus to exclusively performing the conversion from bdgd to OpenDSS, ensuring higher efficiency and precision.
- Independence: The new repository allows for more agile development and greater control over the direction of the project. As the primary maintainer of bdgd2opendss, I can ensure that the project aligns with my vision and goals for the future of this work.
- Future-Proofing: Since bdgd-tools is unlikely to be maintained or used going forward, bdgd2opendss provides a fresh start, ensuring continued development and improvements without being tied to the legacy of the previous project. This new repository will serve as the active and evolving tool for users and collaborators in the future.
By creating bdgd2opendss, I aim to push the boundaries of what was accomplished in bdgd-tools, while ensuring the project remains relevant, focused, and adaptable to the specific challenges of converting bdgd models to OpenDSS.
The development of bdgd2opendss builds upon the efforts of the contributors to the original bdgd-tools project. Special thanks to the following individuals who played a significant role in the success of the original project:
- Ênio Rodrigues - The mastermind behind the outstanding code structure that has made the evolution of the tool easier.
- Paulo Radatz, Lucas Almeida, and Andrey Lopes - Responsible for creating the mapping between the bdgd and OpenDSS models.
- Professor Lucas Melo, Miguel Casemiro, and Mozart Nogueira (Universidade Federal do Ceará) - Improved the tool to near completion and performed valuable validations.
- Professor Carlos Frederico, Guilherme Broslavschi, Ananda, and Raphael Toshio Sakai (Universidade de São Paulo) - Contributed to the development of important features, such as the addition of coordinates and energymeters.
- Ana Camila Mamede (Universidade Federal de Uberlândia)
- Rodolfo Londero
Without their dedication and expertise, this continuation of the project would not have been possible.
To install bdgd2opendss, follow the steps below. If you need support on installation and usage, or if you're interested in learning everything about creating virtual environments, setting up Python projects using PyCharm, and managing Python projects necessary for installation and use, I strongly recommend my Python course Python Sem Mistérios: Instalação, Ambientes Virtuais e Gerenciamento de Projetos. Aula 6.1 summarizes the process of downloading and installing a repository like this one.
Clone the repository:
git clone https://github.com/pauloradatz/bdgd2opendss.git
Navigate to the project directory:
cd bdgd2opendssInstall the required dependencies (It works well with Python 3.11. We need to test other versions and create requirement files for them):
pip install -r requirements_py311.txt
After installation, you can start using bdgd2opendss by importing it into your Python scripts or running the provided command-line tools. Detailed usage examples can be found in the examples folder or in the documentation.
import bdgd2opendss
# Example usageThis project is licensed under the MIT License. See the LICENSE file for more information.
Contributions to bdgd2opendss are welcome! Please refer to our contribution guidelines in CONTRIBUTING.md for details on how you can help improve the project.
If you use bdgd2opendss in your academic work, please reference it as follows:
APA Style:
Radatz, P., & Contributors. (2024). bdgd2opendss: A BDGD to OpenDSS conversion tool (Version X.X.X) [Computer software]. GitHub. https://github.com/pauloradatz/bdgd2opendss
BibTeX Entry:
@software{radatz2024bdgd2opendss,
author = {Paulo Radatz and Contributors},
title = {bdgd2opendss: A BDGD to OpenDSS conversion tool},
year = {2024},
version = {X.X.X},
url = {https://github.com/pauloradatz/bdgd2opendss}
}Please replace X.X.X with the version of the package you are using.
For questions, support, or consulting inquiries, please contact Paulo Radatz at [[email protected]].