معرفی شرکت ها
eta-utility-2.2.3b2
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A framework for researching energy optimization of factory operations
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | eta-utility-2.2.3b2 |
| نام | eta-utility |
| نسخه کتابخانه | 2.2.3b2 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | - |
| ایمیل نویسنده | "Technical University of Darmstadt, Institute for Production Management, Technology and Machine Tools (PTW)." <info@ptw.tu-darmstadt.de> |
| آدرس صفحه اصلی | - |
| آدرس اینترنتی | https://pypi.org/project/eta-utility/ |
| مجوز | BSD 2-Clause License ----------------------- Copyright (c) 2022, Technical University of Darmstadt, Institute for Production Management, Technology and Machine Tools (PTW). All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
ETA Utility Functions
======================
While there are many tools which are useful in the area of energy optimized factory operations, at the
`ETA-Fabrik <https://www.ptw.tu-darmstadt.de>`_ at Technical University of Darmstadt we have recognized a lack of
comprehensive frameworks which combine functionality for optimization, simulation and communication with
devices in the factory.
Therefore, we developed the *eta_utility* framework, which provides a standardized interface for the development
of digital twins of factories or machines in a factory. The framework is based on the OpenAI gym environment
and follows a rolling horizon optimization approach. It provides standardized connectors for multiple
communication protocols, including OPC UA and Modbus TCP. These facilities can be utilized to easily implement
rolling horizon optimizations for factory systems and to directly control devices in the factory with the
optimization results.
Full Documentation can be found on the
`Documentation Page <https://eta-utility.readthedocs.io/>`_.
You can find the `source code on github <https://github.com/PTW-TUDa/eta_utility/>`_. If you would like to contribute, please check our `working repository <https://git.ptw.maschinenbau.tu-darmstadt.de/eta-fabrik/public/eta-utility/>`_.
.. warning::
This is beta software. APIs and functionality might change without prior notice. Please fix the version you
are using in your requirements to ensure your software will not be broken by changes in *eta_utility*.
The package *eta_utility* consists of five main modules and some additional functionality:
- *eta_x* is the rolling horizon optimization module which combines the functionality of the
other modules. It is based on the OpenAI *gym* framework and utilizes algorithms and functions
from the *stable_baselines3* package. *eta_x* also contains extended base classes for
environments and additional agents (or algorithms).
- The *connectors* module provides a standardized way to connect to machines and devices in a
factory or other factory systems (such as energy management systems). The **connectors** can also
handle subscriptions, for example to regularly store values in a database.
- The *servers* module can be used to easily instantiate servers, for example to publish optimization
results.
- *simulators* are interfaces based on the *fmpy* package which provide a way to simulate FMU
(Functional Mockup Unit) models.
The *simulators* can be used to perform quick complete simulations or to step through simulation
models, as would be the case in rolling horizons optimization.
- *timeseries* is an interface based on the *pandas* package to load and manipulate timeseries data
from CSV files. It can for example rename columns, resample data in more complex ways such as
multiple different resampling intervals or select random time slices from data. The *scenario_from_csv* function combines much of this functionality.
- Other functionality includes some general utilities which are available on the top level of the
package.
Some particularities
----------------------
If you want to have logging output from eta utility, call:
.. code-block::
from eta_utility import get_logger
get_logger()
**eta_utility** uses dataframes to pass timeseries data and the dataframes are ensured to
contain timezone information where sensible.
Citing this project
--------------------
Please cite this project using our publication:
.. code-block::
Grosch, B., Ranzau, H., Dietrich, B., Kohne, T., Fuhrländer-Völker D., Sossenheimer, J., Lindner, M., Weigold, M.
A framework for researching energy optimization of factory operations.
Energy Inform 5 (Suppl 1), 29 (2022). https://doi.org/10.1186/s42162-022-00207-6
We would like to thank the many contributors who developed functionality for the package, helped with
documentation or provided insights which helped to create the framework architecture.
- *Niklas Panten* for the first implementation of the rolling horizon optimization now available in
*eta_x*,
- *Nina Strobel* for the first implementation of the connectors,
- *Thomas Weber* for contributions to the rolling horizon optimization with MPC algorithms,
- *Guilherme Fernandes*, *Tobias Koch*, *Tobias Lademann*, *Saahil Nayyer*, *Magdalena Patyna*, *Jerome Stock*,
- and all others who made small and large contributions.
Contributions
--------------------
If you would like to contribute, please create an issue in the repository to discuss you suggestions.
Once the general idea has been agreed upon, you can create a merge request from the issue and
implement your changes there.
BSD 2-Clause License
-----------------------
Copyright (c) 2022, Technical University of Darmstadt, Institute for Production Management, Technology and Machine Tools (PTW).
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
نیازمندی
| مقدار | نام |
|---|---|
| - | setuptools |
| - | attrs |
| - | python-dateutil |
| - | numpy |
| - | pandas |
| - | xlrd |
| - | lxml |
| - | requests |
| - | opcua |
| ==0.2.0 | pyModbusTCP |
| - | cryptography |
| >=0.3.5 | fmpy |
| - | gym |
| - | torch |
| >=1.7 | stable-baselines3 |
| - | tensorboard |
| >=6 | pyomo |
| - | matplotlib |
| - | keyboard |
| - | pygame |
| - | pyglet |
| - | onnxruntime |
| - | pytest |
| - | pytest-cov |
| - | openpyxl |
| - | sphinx |
| - | sphinx-rtd-theme |
| - | pre-commit |
| ==23.1.0 | black |
| ==1.13.0 | blacken-docs |
| ==5.12.0 | isort |
| ==3.3.1 | pyupgrade |
| ==1.0.0 | mypy |
| - | types-python-dateutil |
| - | types-requests |
| ==5.0.4 | flake8 |
| ==5.0.4 | pyproject-flake8 |
| ==2.5.0 | pyflakes |
| ==2.9.1 | pycodestyle |
| ==2.1.0 | flake8-builtins |
| ==1.4.0 | flake8-eradicate |
| ==3.10.1 | flake8-comprehensions |
| ==1.2.0 | flake8-mutable |
| ==5.0.0 | flake8-print |
| ==1.7.2 | flake8-pytest-style |
| ==1.7.7 | flake8-requirements |
| - | pep8-naming |
| ==0.3.0 | flake8-rst-docstrings |
| - | gym |
| - | torch |
| >=1.7 | stable-baselines3 |
| - | tensorboard |
| >=6 | pyomo |
| - | matplotlib |
| - | keyboard |
| - | pygame |
| - | pyglet |
| - | onnxruntime |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| <3.11,>=3.8 | Python |
نحوه نصب
نصب پکیج whl eta-utility-2.2.3b2:
pip install eta-utility-2.2.3b2.whl
نصب پکیج tar.gz eta-utility-2.2.3b2:
pip install eta-utility-2.2.3b2.tar.gz