Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Correction of Various Errors in the Tips and Tricks Documentation #7857

Merged
merged 1 commit into from
Mar 16, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ \subsection{Background and Study using Multipliers}\label{background-and-study-u

For the purposes of dicussion, the buildings will be called: Multistory 1 -- the original 9 zone building (with multipliers and groups) ref: Figure~\ref{fig:original-multistory-idf}; Multistory 2 -- the building shown in Figure~\ref{fig:multistory-with-cloned-middle-zones.}. Multistory with cloned middle zones.; Multistory 3 -- the fully configured building -- ref Figure~\ref{fig:multistory-building-fully-cloned.}.

The following table illustrates the regression testing for Multistory 2 and Multistory 3, group loads and meters versus Multistory 1 results.
The following table illustrates the regression testing for Multistory 2 and Multistory 3, group loads and meters versus Multistory 1 results. For these tables, the location indicators refer to the following EnergyPlus weather files: Chicago (USA IL Chicago-OHare.Intl.AP.725300 TMY3), San Francisco (USA CA San.Francisco.Intl.AP.724940 TMY3), Colorado(USA CO Golden-NREL.724666 TMY3), Tampa (USA FL Tampa.Intl.AP.722110 TMY3), and Washington DC(USA VA Sterling-Washington.Dulles.Intl.AP.724030 TMY3).

% table 1
\begin{longtable}[c]{p{1.2in}p{1.2in}p{1.2in}p{1.2in}p{1.2in}}
Expand All @@ -92,11 +92,11 @@ \subsection{Background and Study using Multipliers}\label{background-and-study-u
\midrule
\endhead

USA\_IL\_Chicago-OHare.Intl.AP.725300\_TMY3 & Small Diffs & Equal & Big Diffs* (76\%) & Big Diffs* (62\%) \tabularnewline
USA\_CA\_San.Francisco.Intl.AP.724940\_TMY3 & Big Diffs* (2.43\%) & Big Diffs* (0.6\%) & Big Diffs* (49\%) & Big Diffs* (41\%) \tabularnewline
USA\_CO\_GOLDEN-NREL.724666\_TMY3 & Small Diffs & Small Diffs & Big Diffs* (26\%) & Big Diffs* (24\%) \tabularnewline
USA\_FL\_Tampa.Intl.AP.722110\_TMY3 & Small Diffs & Small Diffs & Big Diffs* (6\%) & Big Diffs* (2\%) \tabularnewline
USA\_VA\_Sterling-Washington.Dulles.Intl.AP.724030\_TMY3 & Equal & Equal & Big Diffs* (91\%) & Big Diffs* (72\%) \tabularnewline
Chicago & Small Diffs & Equal & Big Diffs* (76\%) & Big Diffs* (62\%) \tabularnewline
San Francisco & Big Diffs* (2.43\%) & Big Diffs* (0.6\%) & Big Diffs* (49\%) & Big Diffs* (41\%) \tabularnewline
Colorado & Small Diffs & Small Diffs & Big Diffs* (26\%) & Big Diffs* (24\%) \tabularnewline
Tampa & Small Diffs & Small Diffs & Big Diffs* (6\%) & Big Diffs* (2\%) \tabularnewline
Washington DC & Equal & Equal & Big Diffs* (91\%) & Big Diffs* (72\%) \tabularnewline
\bottomrule
\end{longtable}

Expand Down Expand Up @@ -137,11 +137,11 @@ \subsection{Background and Study using Multipliers}\label{background-and-study-u
\midrule
\endhead

USA\_IL\_Chicago-OHare.Intl.AP.725300\_TMY3 & Small diffs & Small diffs & Small diffs & Small diffs \tabularnewline
USA\_CA\_San.Francisco.Intl.AP.724940\_TMY3 & Small diffs & Small diffs & Small diffs & Small diffs \tabularnewline
USA\_CO\_GOLDEN-NREL.724666\_TMY3 & Small diffs & Small diffs & Small diffs & Small diffs \tabularnewline
USA\_FL\_Tampa.Intl.AP.722110\_TMY3 & Small diffs & Small diffs & Small diffs & Small diffs \tabularnewline
USA\_VA\_Sterling-Washington.Dulles.Intl.AP.724030\_TMY3 & Small diffs & Small diffs & Small diffs & Small diffs \tabularnewline
Chicago & Small diffs & Small diffs & Small diffs & Small diffs \tabularnewline
San Francisco & Small diffs & Small diffs & Small diffs & Small diffs \tabularnewline
Colorado & Small diffs & Small diffs & Small diffs & Small diffs \tabularnewline
Tampa & Small diffs & Small diffs & Small diffs & Small diffs \tabularnewline
Washington DC & Small diffs & Small diffs & Small diffs & Small diffs \tabularnewline
\bottomrule
\end{longtable}

Expand All @@ -163,11 +163,11 @@ \subsection{Background and Study using Multipliers}\label{background-and-study-u
\midrule
\endhead

USA\_IL\_Chicago-OHare.Intl.AP.725300\_TMY3 & 1:05 & 2:14 & 13:15 \tabularnewline
USA\_CA\_San.Francisco.Intl.AP.724940\_TMY3 & 1:04 & 2:05 & 13:20 \tabularnewline
USA\_CO\_GOLDEN-NREL.724666\_TMY3 & 1:17 & 2:28 & 14:43 \tabularnewline
USA\_FL\_Tampa.Intl.AP.722110\_TMY3 & 1:11 & 2:21 & 13:43 \tabularnewline
USA\_VA\_Sterling-Washington.Dulles.Intl.AP.724030\_TMY3 & 1:05 & 2:15 & 13:18 \tabularnewline
Chicago & 1:05 & 2:14 & 13:15 \tabularnewline
San Francisco & 1:04 & 2:05 & 13:20 \tabularnewline
Colorado & 1:17 & 2:28 & 14:43 \tabularnewline
Tampa & 1:11 & 2:21 & 13:43 \tabularnewline
Washington DC & 1:05 & 2:15 & 13:18 \tabularnewline
\bottomrule
\end{longtable}

Expand All @@ -187,11 +187,11 @@ \subsection{Background and Study using Multipliers}\label{background-and-study-u
\midrule
\endhead

USA\_IL\_Chicago-OHare.Intl.AP.725300\_TMY3 & 0:51 & 1:34 & 9:37 \tabularnewline
USA\_CA\_San.Francisco.Intl.AP.724940\_TMY3 & 0:50 & 1:34 & 9:59 \tabularnewline
USA\_CO\_GOLDEN-NREL.724666\_TMY3 & 0:51 & 1:40 & 10:31 \tabularnewline
USA\_FL\_Tampa.Intl.AP.722110\_TMY3 & 0:51 & 1:36 & 10:05 \tabularnewline
USA\_VA\_Sterling-Washington.Dulles.Intl.AP.724030\_TMY3 & 0:51 & 1:36 & 9:48 \tabularnewline
Chicago & 0:51 & 1:34 & 9:37 \tabularnewline
San Francisco & 0:50 & 1:34 & 9:59 \tabularnewline
Colorado & 0:51 & 1:40 & 10:31 \tabularnewline
Tampa & 0:51 & 1:36 & 10:05 \tabularnewline
Washington DC & 0:51 & 1:36 & 9:48 \tabularnewline
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tables look much nicer here.

\bottomrule
\end{longtable}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,4 @@ \section{Weather Data for Simulations}\label{weather-data-for-simulations}

Drury B. Crawley. 1998. ``Which Weather Data Should You Use for Energy Simulations of Commercial Buildings?'' in ASHRAE Transactions, pp.~498-515, Vol. 104, Pt. 2. Atlanta: ASHRAE. (PDF 197 KB)

PDF: \url{http://energyplus.gov/pdfs/bibliography/whichweatherdatashouldyouuseforenergysimulations.pdf}
Click \href{https://energyplus.net/sites/all/modules/custom/weather/weather_files/whichweatherdatashouldyouuseforenergysimulations.pdf}{here} for the PDF of the above paper.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Works for me.

Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
\chapter{Documentation and Guides}\label{documentation-and-guides}

Note that the PDF documents are fully indexed and searchable. Will save you time and waiting for support to answer on some questions.
Note that all of the documentation for EnergyPlus are formatted as PDF documents and fully indexed and searchable. This will save you time while you are waiting for support to answer on some questions or may even help you find the answer you are looking for without needing to contact support.
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ \subsection{Severe}\label{severe-001}
IP: IDF line~345 Did not find "UNTIL: 22:00" in list of Objects
\end{lstlisting}

You may have entered a semi-colon character (;) at the end of one of the lines in a~\href{http://www.designbuilder.co.uk/programhelp/schedules_-_energyplus_compact_schedules.htm}{Schedule:Compact} when you meant to enter a comma (,). Note that the approximate line number in your file (345) is given to help you locate it in a text editor. Look in the prior line -- it probably needs to end in a comma.
You may have entered a semi-colon character (;) at the end of one of the lines in a Schedule:Compact input when you meant to enter a comma (,). Note that the approximate line number in your file (345) is given to help you locate it in a text editor. Look in the prior line -- it probably needs to end in a comma.

\begin{lstlisting}
IP: IDF line~xxx Did not find "xxxxxx" in list of Objects
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
\section{Variable Refrigerant Flow Air Conditioner}\label{variable-refrigerant-flow-air-conditioner}

\textbf{\emph{The EnergyPlus v7.0 release (October 2011) includes an initial model for VRF systems.~ See AirConditioner:VariableRefrigerantFlow and related objects.}}
\textbf{\emph{Since its V7.0 release (October 2011), EnergyPlus has included a model for VRF systems.~ See AirConditioner:VariableRefrigerantFlow and related objects.}}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Better wording for sure.


\emph{Can I model a VRV or VRF system in EnergyPlus?}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,9 @@ \section{Converting Older Version EnergyPlus Files}\label{converting-older-versi

\emph{Can I convert an older file to a newer version of EnergyPlus?}

If the older version is from the previous release, then yes. Use the pull-down File menu and select Transition. This will update the older file to the newer version.
If the older version is from a previous release (since Version 7.2), then yes. Use the IDF Version Updater utility in the PreProcess folder of your EnergyPlus install. Simply select the file that needs to be updated by finding it on your computer and the click on the Update File button. This will update the older IDF file to the latest version of EnergyPlus installed on the computer.

If the older version is older than the previous release, then you must use the multiple transition program. You can download the transition programs from this site.

(That is \url{http://energyplus.helpserve.com} and go to the ``downloads'' area).
If the older version is older than Version 7.2, then you must use the multiple transition program. You can download the transition programs from the \href{http://energyplus.helpserve.com}{EnergyPlus Help Desk Support} site. After clicking on this link, go to the ``downloads'' tab.

The Multiple Transition folder is set up on the EnergyPlus install.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ \subsection{dxf or dwg CAD Files}\label{dxf-or-dwg-cad-files}

Several EnergyPlus interfaces, including DesignBuilder and \href{https://www.openstudio.net/}{OpenStudio}, allow you to import the dxf drawings and trace over them to create EnergyPlus geometry. If you have the full AutoCAD 3-D dwg model (more than just dxf), then you might be able to export to EnergyPlus using one of the available utilities that work with AutoCAD, but only if the model was created in the correct way to support these tools.

For more information about current tools which support EnergyPlus, see \url{https://www.buildingenergysoftwaretools.com/?keys=EnergyPlus}.
Click \href{https://www.buildingenergysoftwaretools.com/?keys=EnergyPlus}{here} for more information about current tools which support EnergyPlus.

\subsection{OpenStudio}\label{openstudio}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,9 @@ \subsection{WINDOW Data File}\label{window-data-file}

Please note that there is a bug in WINDOW 5 that causes two of the lines in the EnergyPlus data file to be joined. This bug is fixed in versions of Window 5.02 (and above). To be sure, you can check the data file for a line that looks like:

GLAZING SYSTEM OPTICAL DATAAngle~~~~ 0~~~ 10~~~ 20~~~ 30~~~ 40~~~ 50~~~ 60~~~ 70~~~ 80~~~ 90 Hemis
GLAZING SYSTEM OPTICAL DATA
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍


Angle~~~~ 0~~~ 10~~~ 20~~~ 30~~~ 40~~~ 50~~~ 60~~~ 70~~~ 80~~~ 90 Hemis

The fixed version of the program will not show the above line; rather, there will be two lines such as shown below. If you have the above condition, with an editor you would break this into two lines:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,4 @@ \section{Schedules off by 1 hour}\label{schedules-off-by-1-hour}

When active, DaylightSavingTime will shift all scheduled items by one hour. Reporting is always in standard time and uses the same day (scheduled values wrap). In short, the Daylight Saving Time flag uses the schedule value from the \emph{next hour} in the simulation. This can be confusing if your schedules are not symmetric around the midnight hours. Because\ldots{} the new schedule value will show up on the \emph{same day}, not the next day as it might in real life. EnergyPlus does not currently to look ahead/back for next hour schedules (particularly at day boundaries).

More information on Daylight Saving Periods can be seen on the web at: \url{http://www.webexhibits.org/daylightsaving/}
More information on Daylight Saving Periods can be seen on the web \href{http://www.webexhibits.org/daylightsaving/}{here}.
2 changes: 2 additions & 0 deletions doc/tips-and-tricks-using-energyplus/src/utilities.tex
Original file line number Diff line number Diff line change
@@ -1 +1,3 @@
\chapter{Utilities}\label{utilities}

EnergyPlus comes with a wide variety of pre- and post-processing that are found in the PreProcess and PostProcess folders in the main EnergyPlus install folder. These utilities have been developed since the initial release of EnergyPlus and can be helpful during the creation of input data for EnergyPlus or interpreting its output.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah that'll be better than nothing...literally!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know! 😂😂😂 How long has this been like this?🤦‍♂️ Thanks for reviewing this!