From ca172a98f24a349c0c6a92790170f39fdfc6558f Mon Sep 17 00:00:00 2001 From: CoprDistGit Date: Mon, 15 May 2023 06:58:54 +0000 Subject: automatic import of python-3etool --- .gitignore | 1 + python-3etool.spec | 408 +++++++++++++++++++++++++++++++++++++++++++++++++++++ sources | 1 + 3 files changed, 410 insertions(+) create mode 100644 python-3etool.spec create mode 100644 sources diff --git a/.gitignore b/.gitignore index e69de29..bf5f6d9 100644 --- a/.gitignore +++ b/.gitignore @@ -0,0 +1 @@ +/3ETool-0.8.2.tar.gz diff --git a/python-3etool.spec b/python-3etool.spec new file mode 100644 index 0000000..d2d3492 --- /dev/null +++ b/python-3etool.spec @@ -0,0 +1,408 @@ +%global _empty_manifest_terminate_build 0 +Name: python-3ETool +Version: 0.8.2 +Release: 1 +Summary: Tools for performing exergo-economic and exergo-environmental analysis +License: GNU GPLv3 +URL: https://tinyurl.com/SERG-3ETool +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/9f/ed/3b43cb00796747aa722dc1c675587ab1a3747b083aa8eb88146a3886eb7e/3ETool-0.8.2.tar.gz +BuildArch: noarch + + +%description +# 3ETool + +__3ETool__ contains some useful tools developed by the [SERG research group](https://www.dief.unifi.it/vp-177-serg-group-english-version.html) +of the [University of Florence](https://www.unifi.it/changelang-eng.html) for performing exergo-economic and exergo environmental analysis. The __user manual__ can be downloaded [here](https://firebasestorage.googleapis.com/v0/b/etapp-serggroup.appspot.com/o/3ETool_res%2FOther%2FUser%20Guide-eng.pdf?alt=media&token=db51ff1e-4c63-48b9-8b42-322a2eee44da). Moreover, some [youtube tutorials](https://www.youtube.com/playlist?list=PLj6A7PjCJLfa9xNOFwRc3D_XroWhKlptj) have been uploaded in order to help the user in compiling the excel file. + +### 1 - Calculation process 🤔⚙ +The beta version can be downloaded using __PIP__: +``` +pip install 3ETool +``` +Once the installation has been completed the user can import the tool, and paste to a desired location the __user manual__, the __components documentation__ or the __default excel file__, as in the _matlab version_ of the app. +```python +import EEETools + +EEETools.paste_user_manual() +EEETools.paste_components_documentation() +EEETools.paste_default_excel_file() +``` +Finally, once the Excel file has been compiled, the calculation can be initialized trough this command: +```python +import EEETools + +EEETools.calculate() +``` +calculation options and user defined excel path can be passed to the function as well (default values are _true_); in case user does not pass the path, the app will automatically open a filedialog window so that it can be selected manually +```python +import EEETools + +EEETools.calculate( + + excel_path="your_excel_file.xlsx", + calculate_on_pf_diagram = True, + loss_cost_is_zero = True, + valve_is_dissipative = True, + condenser_is_dissipative = True + +) +``` +### 2 - Debugging tools 👨‍💻🔍 +Excel file can be debugged using some specific tools that can be launched using the following command (please select the +Excel file that you want to debug on program request): +```python +import EEETools +EEETools.launch_connection_debug() +``` +Another possible way of debugging the code is to ask the program to export the debug information on the Excel file: +```python +import EEETools +EEETools.export_debug_information() +``` +Finally, topology can be displayed using: +```python +import EEETools +EEETools.launch_network_display() +``` +### 3 - Sankey Diagrams 📈📊 +Sankey diagram can be plotted using the following command: +```python +import EEETools +EEETools.plot_sankey( + + generate_on_pf_diagram=True, + display_costs=True, + +) +``` +* ___generate_on_pf_diagram___ can be omitted and + __is True by default__: + + - if __False__ the connections are defined according to the __physical topology__ of the plant + - if __True__ the connections are based on the __product-fuel__ definition + + +* ___display_costs___ can be omitted and + __is False by default__: + + - if __False__ the thickness of the connection in the sankey diagram is proportional to the __exergy flux__ between + the components (in _kW_) + + - if __True__ the thickness of the connection in the sankey diagram is proportional to the + __economic (or environmental) flux__ between the components (in _€/s_ or in _Pts/s_). In addition, for each + connection, the __color intensity__ is proportional to the __relative cost of the stream__ (in _€/kJ_ or in _Pts/kJ_) + + +### 4 - Code Structure 📁 + +__The application code is divided into 3 main folders:__

+__MainModules__ directory contains Base modules such as _Block, Connection, ArrayHandler and Drawer Classes._
+__Block Sublcasses__ contains a Block subclass for each component type (e.g. expander, compressor etc.)
+__Tools__ contains different APIs needed for the program to run (e.g. the cost correlation handler, +the EES code generator, and the importer and exporter for both Excel and xml files) + +### 5 - Important Information ⚠ + +__-------------------------- !!! THIS IS A BETA VERSION !!! --------------------------__ + +please report any bug or problems in the installation to _pietro.ungar@unifi.it_
+for further information visit: https://tinyurl.com/SERG-3ETool + +__-------------------------------- !!! HOW TO CITE !!! --------------------------------__ + +The following reference can be used to cite the tool in publications: + + Fiaschi, D., Manfrida, G., Ungar, P., Talluri, L. + + Development of an exergo-economic and exergo-environmental tool for power plant assessment: + evaluation of a geothermal case study. + + https://doi.org/10.52202/062738-0003 + + + + + +%package -n python3-3ETool +Summary: Tools for performing exergo-economic and exergo-environmental analysis +Provides: python-3ETool +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-3ETool +# 3ETool + +__3ETool__ contains some useful tools developed by the [SERG research group](https://www.dief.unifi.it/vp-177-serg-group-english-version.html) +of the [University of Florence](https://www.unifi.it/changelang-eng.html) for performing exergo-economic and exergo environmental analysis. The __user manual__ can be downloaded [here](https://firebasestorage.googleapis.com/v0/b/etapp-serggroup.appspot.com/o/3ETool_res%2FOther%2FUser%20Guide-eng.pdf?alt=media&token=db51ff1e-4c63-48b9-8b42-322a2eee44da). Moreover, some [youtube tutorials](https://www.youtube.com/playlist?list=PLj6A7PjCJLfa9xNOFwRc3D_XroWhKlptj) have been uploaded in order to help the user in compiling the excel file. + +### 1 - Calculation process 🤔⚙ +The beta version can be downloaded using __PIP__: +``` +pip install 3ETool +``` +Once the installation has been completed the user can import the tool, and paste to a desired location the __user manual__, the __components documentation__ or the __default excel file__, as in the _matlab version_ of the app. +```python +import EEETools + +EEETools.paste_user_manual() +EEETools.paste_components_documentation() +EEETools.paste_default_excel_file() +``` +Finally, once the Excel file has been compiled, the calculation can be initialized trough this command: +```python +import EEETools + +EEETools.calculate() +``` +calculation options and user defined excel path can be passed to the function as well (default values are _true_); in case user does not pass the path, the app will automatically open a filedialog window so that it can be selected manually +```python +import EEETools + +EEETools.calculate( + + excel_path="your_excel_file.xlsx", + calculate_on_pf_diagram = True, + loss_cost_is_zero = True, + valve_is_dissipative = True, + condenser_is_dissipative = True + +) +``` +### 2 - Debugging tools 👨‍💻🔍 +Excel file can be debugged using some specific tools that can be launched using the following command (please select the +Excel file that you want to debug on program request): +```python +import EEETools +EEETools.launch_connection_debug() +``` +Another possible way of debugging the code is to ask the program to export the debug information on the Excel file: +```python +import EEETools +EEETools.export_debug_information() +``` +Finally, topology can be displayed using: +```python +import EEETools +EEETools.launch_network_display() +``` +### 3 - Sankey Diagrams 📈📊 +Sankey diagram can be plotted using the following command: +```python +import EEETools +EEETools.plot_sankey( + + generate_on_pf_diagram=True, + display_costs=True, + +) +``` +* ___generate_on_pf_diagram___ can be omitted and + __is True by default__: + + - if __False__ the connections are defined according to the __physical topology__ of the plant + - if __True__ the connections are based on the __product-fuel__ definition + + +* ___display_costs___ can be omitted and + __is False by default__: + + - if __False__ the thickness of the connection in the sankey diagram is proportional to the __exergy flux__ between + the components (in _kW_) + + - if __True__ the thickness of the connection in the sankey diagram is proportional to the + __economic (or environmental) flux__ between the components (in _€/s_ or in _Pts/s_). In addition, for each + connection, the __color intensity__ is proportional to the __relative cost of the stream__ (in _€/kJ_ or in _Pts/kJ_) + + +### 4 - Code Structure 📁 + +__The application code is divided into 3 main folders:__

+__MainModules__ directory contains Base modules such as _Block, Connection, ArrayHandler and Drawer Classes._
+__Block Sublcasses__ contains a Block subclass for each component type (e.g. expander, compressor etc.)
+__Tools__ contains different APIs needed for the program to run (e.g. the cost correlation handler, +the EES code generator, and the importer and exporter for both Excel and xml files) + +### 5 - Important Information ⚠ + +__-------------------------- !!! THIS IS A BETA VERSION !!! --------------------------__ + +please report any bug or problems in the installation to _pietro.ungar@unifi.it_
+for further information visit: https://tinyurl.com/SERG-3ETool + +__-------------------------------- !!! HOW TO CITE !!! --------------------------------__ + +The following reference can be used to cite the tool in publications: + + Fiaschi, D., Manfrida, G., Ungar, P., Talluri, L. + + Development of an exergo-economic and exergo-environmental tool for power plant assessment: + evaluation of a geothermal case study. + + https://doi.org/10.52202/062738-0003 + + + + + +%package help +Summary: Development documents and examples for 3ETool +Provides: python3-3ETool-doc +%description help +# 3ETool + +__3ETool__ contains some useful tools developed by the [SERG research group](https://www.dief.unifi.it/vp-177-serg-group-english-version.html) +of the [University of Florence](https://www.unifi.it/changelang-eng.html) for performing exergo-economic and exergo environmental analysis. The __user manual__ can be downloaded [here](https://firebasestorage.googleapis.com/v0/b/etapp-serggroup.appspot.com/o/3ETool_res%2FOther%2FUser%20Guide-eng.pdf?alt=media&token=db51ff1e-4c63-48b9-8b42-322a2eee44da). Moreover, some [youtube tutorials](https://www.youtube.com/playlist?list=PLj6A7PjCJLfa9xNOFwRc3D_XroWhKlptj) have been uploaded in order to help the user in compiling the excel file. + +### 1 - Calculation process 🤔⚙ +The beta version can be downloaded using __PIP__: +``` +pip install 3ETool +``` +Once the installation has been completed the user can import the tool, and paste to a desired location the __user manual__, the __components documentation__ or the __default excel file__, as in the _matlab version_ of the app. +```python +import EEETools + +EEETools.paste_user_manual() +EEETools.paste_components_documentation() +EEETools.paste_default_excel_file() +``` +Finally, once the Excel file has been compiled, the calculation can be initialized trough this command: +```python +import EEETools + +EEETools.calculate() +``` +calculation options and user defined excel path can be passed to the function as well (default values are _true_); in case user does not pass the path, the app will automatically open a filedialog window so that it can be selected manually +```python +import EEETools + +EEETools.calculate( + + excel_path="your_excel_file.xlsx", + calculate_on_pf_diagram = True, + loss_cost_is_zero = True, + valve_is_dissipative = True, + condenser_is_dissipative = True + +) +``` +### 2 - Debugging tools 👨‍💻🔍 +Excel file can be debugged using some specific tools that can be launched using the following command (please select the +Excel file that you want to debug on program request): +```python +import EEETools +EEETools.launch_connection_debug() +``` +Another possible way of debugging the code is to ask the program to export the debug information on the Excel file: +```python +import EEETools +EEETools.export_debug_information() +``` +Finally, topology can be displayed using: +```python +import EEETools +EEETools.launch_network_display() +``` +### 3 - Sankey Diagrams 📈📊 +Sankey diagram can be plotted using the following command: +```python +import EEETools +EEETools.plot_sankey( + + generate_on_pf_diagram=True, + display_costs=True, + +) +``` +* ___generate_on_pf_diagram___ can be omitted and + __is True by default__: + + - if __False__ the connections are defined according to the __physical topology__ of the plant + - if __True__ the connections are based on the __product-fuel__ definition + + +* ___display_costs___ can be omitted and + __is False by default__: + + - if __False__ the thickness of the connection in the sankey diagram is proportional to the __exergy flux__ between + the components (in _kW_) + + - if __True__ the thickness of the connection in the sankey diagram is proportional to the + __economic (or environmental) flux__ between the components (in _€/s_ or in _Pts/s_). In addition, for each + connection, the __color intensity__ is proportional to the __relative cost of the stream__ (in _€/kJ_ or in _Pts/kJ_) + + +### 4 - Code Structure 📁 + +__The application code is divided into 3 main folders:__

+__MainModules__ directory contains Base modules such as _Block, Connection, ArrayHandler and Drawer Classes._
+__Block Sublcasses__ contains a Block subclass for each component type (e.g. expander, compressor etc.)
+__Tools__ contains different APIs needed for the program to run (e.g. the cost correlation handler, +the EES code generator, and the importer and exporter for both Excel and xml files) + +### 5 - Important Information ⚠ + +__-------------------------- !!! THIS IS A BETA VERSION !!! --------------------------__ + +please report any bug or problems in the installation to _pietro.ungar@unifi.it_
+for further information visit: https://tinyurl.com/SERG-3ETool + +__-------------------------------- !!! HOW TO CITE !!! --------------------------------__ + +The following reference can be used to cite the tool in publications: + + Fiaschi, D., Manfrida, G., Ungar, P., Talluri, L. + + Development of an exergo-economic and exergo-environmental tool for power plant assessment: + evaluation of a geothermal case study. + + https://doi.org/10.52202/062738-0003 + + + + + +%prep +%autosetup -n 3ETool-0.8.2 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-3ETool -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Mon May 15 2023 Python_Bot - 0.8.2-1 +- Package Spec generated diff --git a/sources b/sources new file mode 100644 index 0000000..bc556d3 --- /dev/null +++ b/sources @@ -0,0 +1 @@ +cc6ced580c768164e3acccd0744497c4 3ETool-0.8.2.tar.gz -- cgit v1.2.3