Package: tesp-support
Transactive Energy Simulation Platform (TESP) simulates
the electric power distribution grid with transactive control
of loads and resources. Current features include:GridLAB-Dfor the distribution system and residential loadsEnergyPlusfor large buildingsMATPOWERorPYPOWERfor the bulk power systemsBindings for transactive agents inPython, Java or C++The goal ofTESPis that researchers can focus their work
on the last item, to push advances in the field.Installationtesp_support can be installed usingpip:$ pip install tesp_supportHowever, in order to be useful, tesp_support needs custom versions of
GridLAB-D and EnergyPlus.  It also requires Python 3.8 or later, withNumPy,SciPy,NetworkX,MatplotlibandPYPOWER.  There are
cross-platform installers of the complete TESP for Windows, Linux and Mac
OS X on GitHub.  ADockerversion is also available for users.Development Work Flow for tesp_supportFrom this directory, ‘pip install -e .’ points Python to this cloned repository for any calls to tesp_support functionsSee thehttps://github.com/pnnl/tesp/tree/master/src/tesp_support/tesp_supportfor a roadmap of existing Python source files, and some documentation.  Any changes or additions to the code need to be made in this directory.Run tests from any other directory on this computerWhen ready, edit the tesp_support version number and dependencies in setup.pyTo deploy follow the instructions in the Python Packaging Guide:Create an account on PyPI if you haven’t yet.Install twine and build: pip install twine buildCreate the source distribution, change to tesp_support directory execute: python3 -m build .Check your distribution files for errors: twine check dist/*(Optional) Upload to the PyPI test server first (note: separate user registration required): twine upload –repository-urlhttps://test.pypi.org/legacy/dist/*Upload to PyPI: twine upload dist/*Any user gets the changes with ‘pip install tesp_support –upgrade’Use ‘pip show tesp_support’ to verify the version and location on your computerUsing TESPThis is a developer’s platform for electric power grid research.  Seehttp://tesp.readthedocs.io/en/latest/for user instructions, andhttp://github.com/pnnl/tespfor source code.Links to DependenciesDockerEnergyPlusGridLAB-DMatplotlibMATPOWERNetworkXNumPyPandaspipPYPOWERPythonSciPyTESPSubdirectoriestesp_support; utilities for building and running using PYPOWER with or without FNCS/HELICS co-simulations.test; scripts that support testing the package; not automated.License & CopyrightCopyright (c) 2017-2023 Battelle Memorial InstituteChangelogVersion 1.0.0 (2017-06-08)Initial releaseVersion 0.2 (2017-10-14)For NIST TE Challenge 2Version 0.1.4 (2018-09-30)For GridAPPS-D DemoGridLAB-D feature/1146 branch with FNCS-controlled switchingVersion 0.1.9 (2018-12-13)Three desktop version installers for Mac, Windows and LinuxTutorial videoDSO+T study filesVersion 0.9.2 (2020-09-11)Support for HELICS and EnergyPlus 9.3Bundled with ns-3 (HELICS) and opendsscmd (FNCS)Execution on Linux or DockerPostprocessing on Linux, Windows or Mac OS XVersion 0.9.5 (2021-03-09)Standalone housing generatorPlot functions can save filesCase-generated SGIP1 exampleFixed the FNCS SGIP1 exampleVersion 1.0.1 (2021-04-23)No longer supports WindowsUpdates to consensus mechanismBalanced three-phase houses for housing generatorRemove deprecated solar and battery attributesUpdate to HELICS 2.6.1Version 1.2.0 (2022-10-3)Added data.py to for shared data with TESP, recommended using TESP installAdded several APIs for plot GridLAB-D and EnergyPlus attributesAdded player serverAdded DSOT agents and feeder generatorsUpdate to HELICS 3.3.0Version 1.2.3 (2022-11-22)Fix the EnergyPlus to work with newer compiler and updated version numberFix read the docs document warnings and fix clean shell script for energyplusAdded Ubuntu apt install version dependencies for 18.04,20.04,22.04Revised pip and venv for install scriptRevised clean scripts, clean up models directoryAdd loadshed* examples for auto testFixed the installation for Ubuntu 22.04Fixed monitor.py and tesp_case.py when not using EnergyPlus,Minor fix for feeders generator when using name_prefixFixed complex python to use helics complex typeVersion 1.2.4 (2022-12-1)Fix version number in tesp_support for PyPI distribution and read the docsFix the version.sh, move documentation to end of the install, fix warning in Consensus_Usecase.rstFix git patch warning for FNCS and EnergyPlusGridLAB-D triplex_node no longer uses power_12_real and power12_reac, this has commented out for SGIP1*.glm filesAdd pypi packaging to stamping process, refined docker build in scripts/docker, moved HELICS version checker to buildVersion 1.3.0 (2023-9-23)Refactor the TESP PyPI installation for better division between api vs custom (one off) fileUpgrade all models(GridLAB-D, EnergyPlus, NS3) to work with HELICS 3.4Add modifier.py for GridLAB-D modelsVersion 1.3.1 (2023-10-3)Fix modifier.py for GridLAB-D models, upgrade np.float to np.float64Version 1.3.2 (2023-10-27)Another fix for model and modifier for GridLAB-D modelsVersion 1.3.3 (2023-12-4)Add tesp_component download in tesp_support pypi, add schedule in model_GLM.pyMinor changes to path for RECS system feederRestructured, new RECS parameters, updated to include income, new hvac setpoint RECS data, teleworking.Fix postposing for DSOTDockerfile for each module getting ready for dockerize COSU SimulationsChange directory structure