Package: 3ETool
3ETool3EToolcontains some useful tools developed by theSERG research groupof theUniversity of Florencefor performing exergo-economic and exergo environmental analysis. Theuser manualcan be downloadedhere. Moreover, someyoutube tutorialshave been uploaded in order to help the user in compiling the excel file.1 - Calculation process 🤔⚙The beta version can be downloaded usingPIP:pip install 3EToolOnce the installation has been completed the user can import the tool, and paste to a desired location theuser manual, thecomponents documentationor thedefault excel file, as in thematlab versionof the app.importEEEToolsEEETools.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:importEEEToolsEEETools.calculate()calculation options and user defined excel path can be passed to the function as well (default values aretrue); in case user does not pass the path, the app will automatically open a filedialog window so that it can be selected manuallyimportEEEToolsEEETools.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):importEEEToolsEEETools.launch_connection_debug()Another possible way of debugging the code is to ask the program to export the debug information on the Excel file:importEEEToolsEEETools.export_debug_information()Finally, topology can be displayed using:importEEEToolsEEETools.launch_network_display()3 - Sankey Diagrams 📈📊Sankey diagram can be plotted using the following command:importEEEToolsEEETools.plot_sankey(generate_on_pf_diagram=True,display_costs=True,)generate_on_pf_diagramcan be omitted andisTrueby default:ifFalsethe connections are defined according to thephysical topologyof the plantifTruethe connections are based on theproduct-fueldefinitiondisplay_costscan be omitted andisFalseby default:ifFalsethe thickness of the connection in the sankey diagram is proportional to theexergy fluxbetween
the components (inkW)ifTruethe thickness of the connection in the sankey diagram is proportional to theeconomic (or environmental) fluxbetween the components (in€/sor inPts/s). In addition, for each
connection, thecolor intensityis proportional to therelative cost of the stream(in€/kJor inPts/kJ)4 - Code Structure 📁The application code is divided into 3 main folders:MainModulesdirectory contains Base modules such asBlock, Connection, ArrayHandler and Drawer Classes.Block Sublcassescontains a Block subclass for each component type (e.g. expander, compressor etc.)Toolscontains 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 topietro.ungar@unifi.itfor 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