Here are some scripts that you may find useful. They are in the folder "./eppy/useful_scripts"
And now for some housekeeping before we start off
In [1]:
import os
os.chdir("../eppy/useful_scripts")
# changes directory, so we are where the scripts are located
In [2]:
# you would normaly install eppy by doing
# python setup.py install
# or
# pip install eppy
# or
# easy_install eppy
# if you have not done so, the following three lines are needed
import sys
# pathnameto_eppy = 'c:/eppy'
pathnameto_eppy = '../../'
sys.path.append(pathnameto_eppy)
If you look in the folder "./eppy/useful_scripts", you fill find the following scripts
The scripts are:
- eppy_version.py
- idfdiff.py
- loopdiagram.py
- eppyreadtest_folder.py
- eppyreadtest_file.pyMany scripts will print out some help information, if you use the --help option. Let us try that
In [3]:
%%bash
# ignore the line above. It simply lets me run a command line from ipython notebook
python eppy_version.py --help
That was useful !
Now let us try running the program
In [4]:
%%bash
# ignore the line above. It simply lets me run a command line from ipython notebook
python eppy_version.py
Most scripts will print the output to a terminal. Sometimes we want to send the output to a file, so that we can save it for posterity. We can do that py using ">" with the filename after that. For eppy_version.py, it will look like this:
Some of the following scripts will generate csv or html outputs. We can direct the output to a file with .html extension and open it in a browser
This script will compare two idf files. The results will be displayed printed in "csv" format or in "html" format.
You would run the script from the command line. This would be the terminal on Mac or unix, and the dos prompt on windows. Let us look at the help for this script, by typing:
In [5]:
%%bash
# ignore the line above. It simply lets me run a command line from ipython notebook
python idfdiff.py -h
Now let us try this with two "idf" files that are slightly different. If we open them in a file comparing software, it would look like this:
In [6]:
from eppy.useful_scripts import doc_images #no need to know this code, it just shows the image below
for_images = doc_images
for_images.display_png(for_images.filemerge) # display the image below
There are 4 differences between the files. Let us see what idfdiff.py does with the two files. We will use the --html option to print out the diff in html format.
In [7]:
%%bash
# python idfdiff.py idd file1 file2
python idfdiff.py --html ../resources/iddfiles/Energy+V7_2_0.idd ../resources/idffiles/V_7_2/constructions.idf ../resources/idffiles/V_7_2/constructions_diff.idf
file1 = ../resources/idffiles/V_7_2/constructions.idf
file2 = ../resources/idffiles/V_7_2/constructions_diff.idf
| Object Key | Object Name | Field Name | file1 | file2 |
|---|---|---|---|---|
| MATERIAL | F08 Metal surface | not here | is here | |
| MATERIAL | F08 Metal surface haha | is here | not here | |
| MATERIAL | G05 25mm wood | Conductivity | 0.15 | 0.155 |
| CONSTRUCTION | Exterior Door | Outside Layer | F08 Metal surface | F08 Metal surface haha |
It does look like html :-). We need to redirect this output to a file and then open the file in a browser to see what it looks like. Displayed below is the html file
In [8]:
from eppy.useful_scripts import doc_images #no need to know this code, it just shows the image below
from IPython.display import HTML
h = HTML(open(doc_images.idfdiff_path, 'r').read())
h
Out[8]:
Pretty straight forward. Scroll up and look at the origin text files, and see how idfdiff.py understands the difference
Now let us try the same thin in csv format
In [32]:
%%bash
# python idfdiff.py idd file1 file2
python idfdiff.py --csv ../resources/iddfiles/Energy+V7_2_0.idd ../resources/idffiles/V_7_2/constr.idf ../resources/idffiles/V_7_2/constr_diff.idf
We see the same output, but now in csv format. You can redirect it to a ".csv" file and open it up as a spreadsheet
This script will draw all the loops in an idf file. It is a bit of a hack. So it will work on most files, but sometimes it will not :-(. But it is pretty useful when it works.
If it does not work, send us the idf file and we'll try to fix the code
Make sure grapphviz is installed for this script to work
Again, we'll have to run the script from the terminal. Let us look at the help for this script
In [33]:
%%bash
# ignore the line above. It simply lets me run a command line from ipython notebook
python loopdiagram.py --help
Pretty straightforward. Simply open png file and you will see the loop diagram. (ignore the dot file for now. it will be documented later)
So let us try this out with and simple example file. We have a very simple plant loop in "../resources/idffiles/V_7_2/plantloop.idf"
In [34]:
%%bash
# ignore the line above. It simply lets me run a command line from ipython notebook
python loopdiagram.py ../resources/iddfiles/Energy+V7_2_0.idd ../resources/idffiles/V_7_2/plantloop.idf
The script prints out it's progress. On larger files, this might take a few seconds. If we open this file, it will look like the diagram below
Note: the supply and demnd sides are not connected in the diagram, but shown seperately for clarity
In [35]:
from eppy.useful_scripts import doc_images #no need to know this code, it just shows the image below
for_images = doc_images
for_images.display_png(for_images.plantloop) # display the image below
That diagram is not a real system. Does this script really work ?
Try it yourself. Draw the daigram for "../resources/idffiles/V_7_2/5ZoneCAVtoVAVWarmestTempFlow.idf"
Not yet documented
Not yet documented