# eppy.useful_scripts package¶

## eppy.useful_scripts.change_edges module¶

change the edges in loopdaigram so that there are no names with colons (:)

eppy.useful_scripts.change_edges.clean_edges(arg)[source]
eppy.useful_scripts.change_edges.replace_colon(s, replacewith='__')[source]

replace the colon with something

eppy.useful_scripts.change_edges.test_cleanedges()[source]

py.test for cleanedges

eppy.useful_scripts.change_edges.test_replace_colon()[source]

py.test for replace_colon

## eppy.useful_scripts.eppy_version module¶

I print the current version of eppy. Being polite, I also say hello !

script to test idf reads in eppy. Use to read test a single idf file This may may be one of the files that failed when running eppyreadtest_folder.py - eppyreadtest_file.py will output two files: 1. simpleread.idf 2. eppyread.idf

The idf objects in both are sorted in ascending order. The files should be identical. If there is a mismatch, eppy made a mistake in the read. Comparing the two files will show you where the error occurred.

eppy.useful_scripts.eppyreadtest_file.doreadtest(iddfile, folder, silent=False)[source]

print out all the readtest results

script to test idf reads. Use this to test all the files in the example folder when a new version is released

eppy.useful_scripts.eppyreadtest_folder.doreadtest(iddfile, folder, silent=False)[source]

print out all the readtest results

## eppy.useful_scripts.idfdiff module¶

Do a diff between two idf files. Prints the diff in csv or html file format. You can redirect the output to a file and open the file using as a spreadsheet or by using a browser

class eppy.useful_scripts.idfdiff.DtlsSorter(dtls)[source]

Bases: object

helps me to sort it using the order of keys in idd file

getkey(item)[source]
exception eppy.useful_scripts.idfdiff.IDDMismatchError[source]

Bases: Exception

exception eppy.useful_scripts.idfdiff.Usage(msg)[source]

Bases: Exception

eppy.useful_scripts.idfdiff.getobjname(item)[source]

return obj name or blank

eppy.useful_scripts.idfdiff.heading2table(soup, table, row)[source]

eppy.useful_scripts.idfdiff.htmlinnotebook(soup)[source]

display the html in jupyter notebook

eppy.useful_scripts.idfdiff.idfdiffs(idf1, idf2)[source]

return the diffs between the two idfs

eppy.useful_scripts.idfdiff.makecsv(csvdiffs)[source]

retun the csv of the diffs

eppy.useful_scripts.idfdiff.makecsvdiffs(thediffs, idf1, idf2)[source]

return the csv to be displayed

eppy.useful_scripts.idfdiff.makecsvdiffs_raw(thediffs, dtls, n1, n2)[source]

return the csv to be displayed - the args here are tricky This function is called by makecsvdiffs. Best not to call directly

eppy.useful_scripts.idfdiff.makehtmlsoup(csvdiffs)[source]

make the html soup

eppy.useful_scripts.idfdiff.printcsv(csvdiffs)[source]

print the csv

eppy.useful_scripts.idfdiff.printhtml(csvdiffs)[source]

print the html

eppy.useful_scripts.idfdiff.row2table(soup, table, row)[source]

ad a row to the table

eppy.useful_scripts.idfdiff.theheader(n1, n2)[source]

## eppy.useful_scripts.idfdiff_missing module¶

Do a diff between two idf files. Prints the diff in csv or html file format. You can redirect the output to a file and open the file using as a spreadsheet or by using a browser

class eppy.useful_scripts.idfdiff_missing.DtlsSorter(dtls)[source]

Bases: object

helps me to sort it using the order of keys in idd file

getkey(item)[source]
exception eppy.useful_scripts.idfdiff_missing.Usage(msg)[source]

Bases: Exception

eppy.useful_scripts.idfdiff_missing.getobjname(item)[source]

return obj name or blank

eppy.useful_scripts.idfdiff_missing.heading2table(soup, table, row)[source]

eppy.useful_scripts.idfdiff_missing.idfdiffs(idf1, idf2)[source]

return the diffs between the two idfs

eppy.useful_scripts.idfdiff_missing.makecsvdiffs(thediffs, dtls, n1, n2)[source]

return the csv to be displayed

eppy.useful_scripts.idfdiff_missing.printcsv(csvdiffs)[source]

print the csv

eppy.useful_scripts.idfdiff_missing.printhtml(csvdiffs)[source]

print the html

eppy.useful_scripts.idfdiff_missing.row2table(soup, table, row)[source]

ad a row to the table

eppy.useful_scripts.idfdiff_missing.theheader(n1, n2)[source]

## eppy.useful_scripts.loopdiagram module¶

Draw all the loops in the IDF file.

There are two output files saved in the same location as the idf file: - idf_file_location/idf_filename.dot - idf_file_location/idf_filename.png

eppy.useful_scripts.loopdiagram.bothnodes(edge)[source]
eppy.useful_scripts.loopdiagram.clean_edges(arg)[source]
eppy.useful_scripts.loopdiagram.dropnodes(edges)[source]

draw a graph without the nodes

eppy.useful_scripts.loopdiagram.edges2nodes(edges)[source]

gather the nodes from the edges

eppy.useful_scripts.loopdiagram.firstisnode(edge)[source]
eppy.useful_scripts.loopdiagram.getedges(fname, iddfile)[source]

return the edges of the idf file fname

eppy.useful_scripts.loopdiagram.istuple(x)[source]
eppy.useful_scripts.loopdiagram.main()[source]
eppy.useful_scripts.loopdiagram.make_and_save_diagram(fname, iddfile)[source]
eppy.useful_scripts.loopdiagram.makeabranch(name)[source]
eppy.useful_scripts.loopdiagram.makeairplantloop(data, commdct)[source]

make the edges for the airloop and the plantloop

eppy.useful_scripts.loopdiagram.makeanode(name)[source]
eppy.useful_scripts.loopdiagram.makebranchcomponents(data, commdct, anode='epnode')[source]

return the edges jointing the components of a branch

eppy.useful_scripts.loopdiagram.makediagram(edges)[source]

make the diagram with the edges

eppy.useful_scripts.loopdiagram.makeendnode(name)[source]
eppy.useful_scripts.loopdiagram.nodetype(anode)[source]

return the type of node

eppy.useful_scripts.loopdiagram.process_idf(fname, iddfile)[source]
eppy.useful_scripts.loopdiagram.replace_colon(s, replacewith='__')[source]

replace the colon with something

eppy.useful_scripts.loopdiagram.save_diagram(fname, g, silent=False)[source]
eppy.useful_scripts.loopdiagram.secondisnode(edge)[source]
eppy.useful_scripts.loopdiagram.transpose2d(mtx)[source]

Transpose a 2d matrix [

[1,2,3], [4,5,6] ]

becomes [

[1,4], [2,5], [3,6] ]