Differences between revisions 33 and 82 (spanning 49 versions)
⇤ ← Revision 33 as of 2009-06-30 00:30:31 →
Size: 3625
Editor: MichaelWetter
Comment:
← Revision 82 as of 2010-11-17 19:13:37 → ⇥
Size: 12957
Editor: MichaelWetter
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#pragma section-numbers 2
#acl MichaelWetter:read,write All:read
Line 2: Line 5:
The BCVTB release includes the source code and binary files that are compiled for Windows. You can compile the source code on Mac OS X, Linux and Windows. The BCVTB release includes the binary files that are compiled for Windows, Mac OS X, and Linux.
Line 4: Line 7:
Prior to using or compiling the BCVTB, you will need to install and compile Ptolemy II. Proceed as follows:
 a. If you use Windows and do not want to compile the BCVTB source code, follow the [:InstallationUser:user installation instruction].
 a. Otherwise, follow the [:InstallationDeveloper:developer installation instruction].		 To install the BCVTB, proceed as follows:
 1. Follow the [[http://simulationresearch.lbl.gov/bcvtb/latest/doc/manual/installation.xhtml|user installation instruction]]. This is sufficient for most users.
 1. Next, if you like to develop new code for Ptolemy or for the BCVTB interface, follow the [[http://simulationresearch.lbl.gov/bcvtb/latest/doc/manual/development.xhtml|developer installation instruction]].
Line 8: Line 11:
'''Note for users of Microsoft Internet Explorer:''' Internet Explorer may save the file with the extension {{{.zip}}} instead of {{{.jar}}}. To avoid this, click "Save Target As..." (using the right mouse button) and then enter the name of the installation file, for example, {{{bcvtb-install-0.1.0.jar}}}. (Or use Firefox to avoid this problem.) '''Note for users of Microsoft Internet Explorer:''' Internet Explorer may save the file with the extension {{{.zip}}} instead of {{{.jar}}}. To avoid this, click "Save Target As..." (using the right mouse button) and then enter the name of the installation file, for example, {{{bcvtb-install-0.6.0.jar}}}. (Or use Firefox to avoid this problem.)

<<TableOfContents(2)>>

== Release 0.8.0 (November 17, 2010) ==
=== Download ===
||Manual || [[http://simulationresearch.lbl.gov/bcvtb/releases/0.8.0/doc/manual/index.xhtml|html]], [[http://simulationresearch.lbl.gov/bcvtb/releases/0.8.0/doc/manual/bcvtb-manual.pdf|pdf]] ||
||Windows || [[http://simulationresearch.lbl.gov/bcvtb/releases/0.8.0/bcvtb-install-win32-0.8.0.jar|bcvtb-install-win32-0.8.0.jar]] ||
||Linux || [[http://simulationresearch.lbl.gov/bcvtb/releases/0.8.0/bcvtb-install-linux32-0.8.0.jar|bcvtb-install-linux32-0.8.0.jar]] ||
||Mac OS X || [[http://simulationresearch.lbl.gov/bcvtb/releases/0.8.0/bcvtb-install-mac64-0.8.0.jar|bcvtb-install-mac64-0.8.0.jar]] ||
Note that these versions work with !EnergyPlus 6.0, which needs to be downloaded separately from http://www.energyplus.gov.

=== Release notes ===
This version contains the following updates:
 1. Improved documentation for all actors, including the examples for how to use the different actors.
 1. Added examples for !EnergyPlus 6.0.
 1. Fixed a bug that occured when hundreds of data were exchanged. Note to !EnergyPlus users: To fix this bug also in !EnergyPlus 6.0.0, build 23, proceed as described [[Download/EnergyPlus-6-0-0-build23|here]].

== Release 0.7.0 (August 9, 2010) ==
=== Download ===
||Manual || [[http://simulationresearch.lbl.gov/bcvtb/releases/0.7.0/doc/manual/index.xhtml|html]], [[http://simulationresearch.lbl.gov/bcvtb/releases/0.7.0/doc/manual/bcvtb-manual.pdf|pdf]] ||
||Windows || [[http://simulationresearch.lbl.gov/bcvtb/releases/0.7.0/bcvtb-install-win32-0.7.0.jar|bcvtb-install-win32-0.7.0.jar]] ||
||Linux || [[http://simulationresearch.lbl.gov/bcvtb/releases/0.7.0/bcvtb-install-linux32-0.7.0.jar|bcvtb-install-linux32-0.7.0.jar]] ||
||Mac OS X || [[http://simulationresearch.lbl.gov/bcvtb/releases/0.7.0/bcvtb-install-mac64-0.7.0.jar|bcvtb-install-mac64-0.7.0.jar]] ||
Note that these versions work with !EnergyPlus 5.0, which needs to be downloaded separately from http://www.energyplus.gov.

=== Release notes ===
This version contains the following updates:
 1. Addition of the BACnet interface that can read to and write from BACnet devices.
 1. Addition of examples for Radiance.
 1. Completely revised manual.

== Release 0.6.0 (April 27, 2010) ==
=== Download ===
||Windows || [[http://simulationresearch.lbl.gov/bcvtb/releases/0.6.0/bcvtb-install-win32-0.6.0.jar|bcvtb-install-win32-0.6.0.jar]] ||
||Linux || [[http://simulationresearch.lbl.gov/bcvtb/releases/0.6.0/bcvtb-install-linux32-0.6.0.jar|bcvtb-install-linux32-0.6.0.jar]] ||
||Mac OS X || [[http://simulationresearch.lbl.gov/bcvtb/releases/0.6.0/bcvtb-install-mac64-0.6.0.jar|bcvtb-install-mac64-0.6.0.jar]] ||
Note that these versions work with !EnergyPlus 5.0, which needs to be downloaded separately from http://www.energyplus.gov.

=== Release notes ===
This version contains the following updates:
 1. For the !EnergyPlus client, the official version of !EnergyPlus 5.0 can be used. !EnergyPlus needs to be downloaded from http://www.energyplus.gov
 1. The example files have been updated for !EnergyPlus 5.0.
 1. All configurations settings are now in the file [[http://simulationresearch.lbl.gov/bcvtb/latest/doc/manual/settingEnvironmentVariables.xhtml|systemVariables-*.properties]].
 1. The files {{{bin/setenv.sh}}} and {{{bin/setenv.bat}}} have been renamed to {{{bin/setDevelopmentEnvironment.sh}}} and {{{bin/setDevelopmentEnvironment.sh}}}. These files have been changed so that they get all environment variables from the file {{{bin/systemVariables-*.properties}}}. This avoids duplicate entry of system variables.
 1. The Apache Ant build system is now distributed with the BCVTB installation. It will be installed in bcvtb/apache-ant. Existing installations of Apache Ant will not be affected by the BCVTB.
 1. The expat library is included for Windows and Linux. (The default installation of Mac OS X already contains the expat library.)

== Release 0.5.1 (February 9, 2010) ==
=== Download ===
 * [[http://simulationresearch.lbl.gov/bcvtb/releases/0.5.1/bcvtb-install-0.5.1.jar|bcvtb-install-0.5.1.jar]]
 * [[http://simulationresearch.lbl.gov/bcvtb/releases/0.5.0/ep-4.0.zip|ep-4.0.zip]] This zip-file requires a password. To obtain the password, email the password of the official !EnergyPlus installation to ZhengweiLi.

=== Release notes ===
This version contains a bug fix that caused a !NullPointerException if the {{{SystemCommand}}} actor is called
from a finite state machine.

== Release 0.5.0 (February 4, 2010) ==
=== Download ===
 * [[http://simulationresearch.lbl.gov/bcvtb/releases/0.5.0/bcvtb-install-0.5.0.jar|bcvtb-install-0.5.0.jar]]
 * [[http://simulationresearch.lbl.gov/bcvtb/releases/0.5.0/ep-4.0.zip|ep-4.0.zip]] This zip-file requires a password. To obtain the password, email the password of the official !EnergyPlus installation to ZhengweiLi.

=== Release notes ===
This version contains the following updates:
 1. Added a compact schedules to the !EnergyPlus interface.
 2. For the !EnergyPlus interface, changed variable names in xml configuration file {{{variables.cfg}}}. The following name changes have been made
    ||''old''||''new''||
    ||dayschedule|| (Replaced by schedule) ||
    || n/a ||schedule||
Note that the new object {{{schedule}}} is similar to the {{{Schedule:Compact}}} in !EnergyPlus and hence should not be used with a {{{Schedule:Week}}}.
 You will have to manually update your files {{{variables.cfg}}} from earlier BCVTB versions.
 2. For the !EnergyPlus interface, changed variable names in idf files. The following name changes have been made
    ||''old''||''new''||
    ||BCVTB || !ExternalInterface ||
    ||!PtolemyLink || !PtolemyServer ||
    ||Schedule:Day:Dynamic|| (replaced by ExternalInterface:Schedule)||
    || n/a ||ExternalInterface:Schedule||
    || n/a ||ExternalInterface:Actuator||
 You will have to manually update your idf files from earlier BCVTB versions.

== Release 0.4.0 (November 5, 2009) ==
=== Download ===
 * [[http://simulationresearch.lbl.gov/bcvtb/releases/0.4.0/bcvtb-install-0.4.0.jar|bcvtb-install-0.4.0.jar]]
 * [[http://simulationresearch.lbl.gov/bcvtb/releases/0.2.0/ep-3.1.zip|ep-3.1.zip]] This zip-file requires a password. It is the same file as the one that is distributed with the BCVTB version 0.2.0. To obtain the password, email the password of the official !EnergyPlus installation to ZhengweiLi.

=== Release notes ===
This version contains the following updates:
 1. Added a new actor called {{{SystemCommand}}} that allows to call any system command from Ptolemy. See the [[Configuration/SystemCommand|example]] for further information.
 1. Added option to start the BCVTB from a java jar file. This allows to start the BCVTB from a file explorer or from a command line with several options. See [[Files/BCVTBJar|Files/BCVTBJar]] for a description.
 1. Added the example {{{examples/dymolaEPlus31-singleZone}}}, in which an air-based HVAC system that is modeled in Modelica is linked to a building model of !EnergyPlus.

== Release 0.3.1 (September 4, 2009) ==
=== Download ===
 * [[http://simulationresearch.lbl.gov/bcvtb/releases/0.3.1/bcvtb-install-0.3.1.jar|bcvtb-install-0.3.1.jar]]
 * [[http://simulationresearch.lbl.gov/bcvtb/releases/0.2.0/ep-3.1.zip|ep-3.1.zip]] This zip-file requires a password. It is the same file as the one that is distributed with the BCVTB version 0.2.0. To obtain the password, email the password of the official !EnergyPlus installation to ZhengweiLi.

=== Release notes ===
This version is a minor update that addresses the following issues:
 1. For the Simulink interface, fixed a bug that prevented the BCVTB library to be displayed in Simulink's library browser.
 1. Fixed compilation problems on Mac OS X 10.6 (Snow Leopard).

== Release 0.3.0 (August 24, 2009) ==
=== Download ===
 * [[http://simulationresearch.lbl.gov/bcvtb/releases/0.3.0/bcvtb-install-0.3.0.jar|bcvtb-install-0.3.0.jar]]
 * [[http://simulationresearch.lbl.gov/bcvtb/releases/0.2.0/ep-3.1.zip|ep-3.1.zip]] This zip-file requires a password. It is the same file as the one that is distributed with the BCVTB version 0.2.0. To obtain the password, email the password of the official !EnergyPlus installation to ZhengweiLi.

=== Release notes ===
 1. This version contains a subset of Ptolemy. Users do not need to install their own Ptolemy version.
 1. Cygwin is not required anymore.
 1. In the files {{{variables.cfg}}}, the header needs to look like{{{
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE BCVTB-variables SYSTEM "variables.dtd">
<BCVTB-variables>
}}}i.e., you need to add the second line to your existing file.
 1. Due to shipping a new Ptolemy version, the files {{{system.xml}}} and {{{system-windows.xml}}} had to be changed. Previous files can be updated by running the following bash script from the {{{examples}}} directory [[attachment:fixModels.sh]].
Line 11: Line 129:
Download installation files
 * [http://gaia.lbl.gov/bcvtb-releases/0.2.0/bcvtb-install-0.2.0.jar bcvtb-install-0.2.0.jar]
 * [http://gaia.lbl.gov/bcvtb-releases/0.2.0/ep-3.1.zip ep-3.1.zip] This zip-file requires a password. To obtain the password, email the password of the official !EnergyPlus installation to MichaelWetter.		 === Download ===
 * [[http://simulationresearch.lbl.gov/bcvtb/releases/0.2.0/bcvtb-install-0.2.0.jar|bcvtb-install-0.2.0.jar]]
 * [[http://simulationresearch.lbl.gov/bcvtb/releases/0.2.0/ep-3.1.zip|ep-3.1.zip]] This zip-file requires a password. To obtain the password, email the password of the official !EnergyPlus installation to ZhengweiLi.
Line 18: Line 137:
 1. The !EnergyPlus object {{{DAYSCHEDULE:DYNAMIC}}} has been renamed to {{{SCHEDULE:DAY:DYNAMIC}}}.
Line 19: Line 139:
 1. The {{{Simulator}}} object now writes the simulation output to a log file (default is {{{simulation.log}}}) and to the console. However, console output is currently only working on Linux and on Mac OS X. The reason is that Ptolemy on Windows is started using {{{javaw}}} which does not seem write the output stream to the console.  1. The {{{Simulator}}} object now writes the simulation output to a log file (default is {{{simulation.log}}}) and to the console. However, console output is currently only working on Linux and on Mac OS X. The reason is that Ptolemy on Windows is started using {{{javaw}}} which does not write the output stream to the console.
Line 21: Line 141:
Line 22: Line 143:
||Download installation file || [http://gaia.lbl.gov/bcvtb-releases/0.1.1/bcvtb-install-0.1.1.jar bcvtb-install-0.1.1.jar] || === Download ===
||Download installation file || [[http://simulationresearch.lbl.gov/bcvtb/releases/0.1.1/bcvtb-install-0.1.1.jar|bcvtb-install-0.1.1.jar]] ||
Line 24: Line 147:
 1. The [http://www.energyplus.gov EnergyPlus] executable that contains the BCVTB interface is not part of this distribution. To obtain the !EnergyPlus 2.1.0 executable with the BCVTB interface, email a request together with the !EnergyPlus installation password to MichaelWetter.  1. The [[http://www.energyplus.gov|EnergyPlus]] executable that contains the BCVTB interface is not part of this distribution. To obtain the !EnergyPlus 2.1.0 executable with the BCVTB interface, email a request together with the !EnergyPlus installation password to ZhengweiLi.
Line 30: Line 153:
== Release 0.1.0 ==
||Download installation file || [http://gaia.lbl.gov/bcvtb-releases/0.1.0/bcvtb-install-0.1.0.jar bcvtb-install-0.1.0.jar] || Released on July 17, 2008 ||

== Release 0.1.0 (July 17, 2008) ==
=== Download ===
||Download installation file || [[http://simulationresearch.lbl.gov/bcvtb/releases/0.1.0/bcvtb-install-0.1.0.jar|bcvtb-install-0.1.0.jar]] ||
Line 33: Line 160:
 1. The [http://www.energyplus.gov EnergyPlus] executable that contains the BCVTB interface is not part of this distribution. To obtain the !EnergyPlus 2.1.0 executable with the BCVTB interface, email a request together with the !EnergyPlus installation password to MichaelWetter.  1. The [[http://www.energyplus.gov|EnergyPlus]] executable that contains the BCVTB interface is not part of this distribution. To obtain the !EnergyPlus 2.1.0 executable with the BCVTB interface, email a request together with the !EnergyPlus installation password to ZhengweiLi.

Download

The BCVTB release includes the binary files that are compiled for Windows, Mac OS X, and Linux.

To install the BCVTB, proceed as follows:

  1. Follow the user installation instruction. This is sufficient for most users.

  2. Next, if you like to develop new code for Ptolemy or for the BCVTB interface, follow the developer installation instruction.

Note for users of Microsoft Internet Explorer: Internet Explorer may save the file with the extension .zip instead of .jar. To avoid this, click "Save Target As..." (using the right mouse button) and then enter the name of the installation file, for example, bcvtb-install-0.6.0.jar. (Or use Firefox to avoid this problem.)

Contents

  1. Release 0.8.0 (November 17, 2010)
  2. Release 0.7.0 (August 9, 2010)
  3. Release 0.6.0 (April 27, 2010)
  4. Release 0.5.1 (February 9, 2010)
  5. Release 0.5.0 (February 4, 2010)
  6. Release 0.4.0 (November 5, 2009)
  7. Release 0.3.1 (September 4, 2009)
  8. Release 0.3.0 (August 24, 2009)
  9. Release 0.2.0 (June 30, 2009)
  10. Release 0.1.1 (September 30, 2008)
  11. Release 0.1.0 (July 17, 2008)

1. Release 0.8.0 (November 17, 2010)

1.1. Download

Manual

html, pdf

Windows

bcvtb-install-win32-0.8.0.jar

Linux

bcvtb-install-linux32-0.8.0.jar

Mac OS X

bcvtb-install-mac64-0.8.0.jar

Note that these versions work with EnergyPlus 6.0, which needs to be downloaded separately from http://www.energyplus.gov.

1.2. Release notes

This version contains the following updates:

  1. Improved documentation for all actors, including the examples for how to use the different actors.

  2. Added examples for EnergyPlus 6.0.

  3. Fixed a bug that occured when hundreds of data were exchanged. Note to EnergyPlus users: To fix this bug also in EnergyPlus 6.0.0, build 23, proceed as described here.

2. Release 0.7.0 (August 9, 2010)

2.1. Download

Manual

html, pdf

Windows

bcvtb-install-win32-0.7.0.jar

Linux

bcvtb-install-linux32-0.7.0.jar

Mac OS X

bcvtb-install-mac64-0.7.0.jar

Note that these versions work with EnergyPlus 5.0, which needs to be downloaded separately from http://www.energyplus.gov.

2.2. Release notes

This version contains the following updates:

  1. Addition of the BACnet interface that can read to and write from BACnet devices.
  2. Addition of examples for Radiance.
  3. Completely revised manual.

3. Release 0.6.0 (April 27, 2010)

3.1. Download

Windows

bcvtb-install-win32-0.6.0.jar

Linux

bcvtb-install-linux32-0.6.0.jar

Mac OS X

bcvtb-install-mac64-0.6.0.jar

Note that these versions work with EnergyPlus 5.0, which needs to be downloaded separately from http://www.energyplus.gov.

3.2. Release notes

This version contains the following updates:

  1. For the EnergyPlus client, the official version of EnergyPlus 5.0 can be used. EnergyPlus needs to be downloaded from http://www.energyplus.gov

  2. The example files have been updated for EnergyPlus 5.0.

  3. All configurations settings are now in the file systemVariables-*.properties.

  4. The files bin/setenv.sh and bin/setenv.bat have been renamed to bin/setDevelopmentEnvironment.sh and bin/setDevelopmentEnvironment.sh. These files have been changed so that they get all environment variables from the file bin/systemVariables-*.properties. This avoids duplicate entry of system variables.

  5. The Apache Ant build system is now distributed with the BCVTB installation. It will be installed in bcvtb/apache-ant. Existing installations of Apache Ant will not be affected by the BCVTB.
  6. The expat library is included for Windows and Linux. (The default installation of Mac OS X already contains the expat library.)

4. Release 0.5.1 (February 9, 2010)

4.1. Download

4.2. Release notes

This version contains a bug fix that caused a NullPointerException if the SystemCommand actor is called from a finite state machine.

5. Release 0.5.0 (February 4, 2010)

5.1. Download