ARCH653 Final Project

Arch 653 Final Project

For the final project I decided to use the Taipei 101 Tower that I created for Project 1 to implement API programing. In project one, before API programming was learned, the curtain wall panels at the very top of each building family had to be selected individually to change their material properties in order to change the panel color. These panels were changed to make the Revit model of the tower look as close as possible to the real tower. For the final project, with the help of API programming, my first task was to make all of these “top” panels change color simultaneously without having to select each one individually. My second task in the final project was to make the main tower families which make up most of the tower change dimensions simultaneously according to one driving parameter defined in the project level. The reason I decided this to be my second task was because in project one each piece that made the total tower were created as separate mass families. These were then loaded into a total tower family and stacked on top of each other. Finally, the total tower family was loaded into the project file. To change the dimensions of the tower, each family had to be selected separately and their dimensions had to be changed in the corresponding mass family and loaded back into the total mass family, and finally reloaded in the project level. With the use of API programming, this tedious task could be eliminated by linking all of the building family’s dimension parameters to one driving parameter so that all of the dimensions could be changed in the project level at once.

Implementation of API Programming

Curtain Panels

The curtain panel system of the tower was created in three levels: first, the individual curtain panel was created as a curtain panel by pattern family; next, in the total building family level all of the building surfaces were divided and the curtain panel by pattern family was loaded into this family; lastly, the total building family model with the curtain panel system was loaded into the project level. In order to use API programming with the Add-In Manager to change the color of the curtain panels at the top of each building family in the project level, the curtain panel by pattern material parameter had to be linked to the curtain panel material parameter in the total building family model. Once this parameter was linked correctly, the API program could be run by selecting all of the top curtain panels in the total building mass model, extracting all of their ID’s and using a “for loop” in the API code to change the colors of each of these panels randomly. However, making each of these panels a different color was not the intention of this task for the project. It was intended that all of the panels change the same color. Therefore, in order to do this, the part of the code that randomized the color for each panel was taken out of the “for loop” in the API program. This made sure that each time the program was run; the selected panels would change to the same, random color. The figures below show the colors of the top panels changing each time the program was run in Revit after the code was successfully updated.

Project After Running API Program to Change Curtain Panel Color Randomly - 1

Project After Running API Program to Change Curtain Panel Color Randomly - 2

Project After Running API Program to Change Curtain Panel Color Randomly - 3

Project After Running API Program to Change Curtain Panel Color Randomly - 4

Building Dimensions

After the API program to change the top curtain panel’s color was successfully created, the task of changing all of the building family’s dimensions simultaneously in the project level was ready to be tackled. As was previously mentioned, the dimensions of the three main building families that make up most of the tower were chosen to implement this API program. The three building families can be seen in the figures below.

Tower Base

Top Tower

Spire Tower

It was decided to change the base width and height of the base building family, the top width and height of the eight top towers building family, and the top width and height of the spire tower building family. These dimensions were chosen to change because these changes would be most noticeable since the tower is so tall. All of these dimensional changes are based on the tower base family’s base width parameter. Therefore, when this parameter is changed, all of the other building dimensional parameters will change accordingly with a predefined ratio. In order to make this happen, new dimensional parameters for these building families had to be created in the total building family model. These parameters then had to be linked to the parameters of the individual building mass family models. Once all of these parameters were linked correctly, the total building mass family was uploaded to the project level. This enabled these parameters to be accessible in the project level so that the parameters could be read, extracted, and changed in the API Program. After the parameters are read by the API program, they are automatically changed based on the base tower width parameter according to predefined ratios as was explained previously. These predefined ratios can be seen in the equations below.

Base Tower Height = Base Width * 3

Top Tower Top Width = Base Width

Top Tower Height = Base Width

Spire Tower Top Width = Base Width / 2

Spire Tower Height = Base Width / 2

These ratios can easily be changed in the API program to alter the dimensions of the tower however one might choose. After the API program for this task was built successfully the program was run for multiple base width values to demonstrate the changes in dimensions of the rest of the tower. These changes can be seen in the figures below.

Tower Base Width Demension Parameter = 350 feet

Tower Base Width Demension Parameter = 600 feet

Tower Base Width Demension Parameter = 1000 feet

Revit API Issues and Future Work

One of the issues I experienced when trying to use API programming to change the color of the selected curtain panels was figuring out how to link the panel material parameters in each of the family and project levels. At first the individual curtain panel by pattern material parameter was not linked to the panel material parameter in the total building family model. The API program was built successfully, but when it was run in Revit the panel colors did not change. I then linked the curtain panel by pattern family material parameter to the panel material parameter in the total building mass family. After running the API code the panel colors still did not change. However, I realized that I was extracting the panel ID’s from the project level, but the code was written to extract the panel ID’s from the mass family level.  Once I corrected where the panel ID’s were extracted from the colors of the curtain panels changed successfully. Another issue that I encountered was again with linking parameters in the multiple family and project levels for the dimensions of the tower I wanted to simultaneously change. I needed the dimension parameters in the project level to be accessible so that the API program could extract them. I was able to resolve this issue by creating new dimensional parameters in the total building family model and linking them to the parameters of the individual building mass families. Once these parameters were linked, the total building family was reloaded into the project level and the API program written to change the dimensions of the building based on a single parameter was run successfully.

If more time was allotted for this project, there are a couple of things I would have liked to complete. The first thing would be to add exterior spot lights on the corners at the top of each roof level. These spot lights would illuminate the façade of the building and change colors with respect to the day of the week. This attribute is implemented on the real tower. Using API programming I believe that I could get the spot light’s color to change depending on the day I want to see the rendering of the tower. I also would have liked to add more attributes to the façade of the building such as doors and designs that the real tower portrays. Finally, I would like to have had time to make the surrounding area look more like an urban area by adding buildings around the tower, roads, sidewalks, and other components that show the towers real beauty and size.

Higher Resolution Video at:
http://www.youtube.com/watch?v=CQGBFUDIuCE&feature=youtu.be

Introduction

The objective for project 1 is to create a Building Information Model (BIM) and Parametric Design for a selected building of our choice. We are to choose a building that will encompass all of the parametric modeling skills that we have acquired thus far. The parametric modeling of the building was first started by collecting as much information, such as drawings, plans, elevations, etc. on the building as was possible. Once the information was gathered, a parametric, conceptual mass of the building was created. This mass was parametrically controlled so that the geometry of the building could be easily altered. Next, a parametrically controlled envelop family was created and loaded into the building conceptual mass family. Once the parametric mass model was created, a detailed BIM model of the building was created that included: walls, floors, ceilings, windows, and floor plans with accompanying furniture. Finally, realistic renderings of the interior and exterior of the building were created along with various screenshots that displayed how the building model could be parametrically altered.

Proposed Building Model

The building I chose to model for the project was the Taipei 101 Tower located in Taiwan. The Taipei 101 Tower can be seen in Figures 1 and 2 below. Construction of Taipei 101 began in 1999 and was completed in 2004. It is currently the world’s fourth tallest building in the following categories: structurally, roof height, highest occupied floor. The spire reaches a height of 1,667 feet while the roof and the top floor reach heights of 1,470 feet and 1,457 feet, respectively. The tower also includes five basement floors which extend 103 feet below ground level.

Figure 1: Taipei 101 at Dusk (Taipei Financial Center Corp. 2009)

Figure 2: Exterior Facade (Sekavic 2005)

Taipei 101 has multiple uses, but is mainly an office building. It houses retail facilities on floors 1 – 4, a fitness center on floors 5 and 6, offices on floors 7 – 84, restaurants on floors 86 – 88, observation decks on floors 89, 91, and 101, and communication facilities on floors 92 – 100. Beneath the building is a station for the Taipei Mass Rapid Transit (MRT) awaiting the construction of the Hsinyi line. The tower also includes the two fastest elevators in the world installed by Toshiba and has a 900 ton tuned mass damper on the 87th floor to counteract earthquakes and typhoons. (Skyscraper Source Media Inc. 2012) The design and architecture of the building is heavily based on the Chinese culture. The building protrudes from the ground like a bamboo shoot and the eight inverted trapezoidal sections that make up the majority of the tower use the Chinese pagoda as their form. The eight trapezoidal sections also represent the lucky number eight which means blooming or success. Most aspects of the design, layout and planning of the tower were consulted on by a Feng Shui master. (Sekavic 2005) The façade of the tower is composed of unitized glass wall and steel.

Parametric Design Intent

As can be seen from the schematic representation of Taipei 101 in Figure 3 below, the tower is essentially constructed by stacking various “blocks” on top of each other. The two main components of the tower are the base trapezoidal section and the eight inverted trapezoidal sections above the base. The base component is wider at the base than at the top, while the upper eight components are wider at the top than at the base creating the sloping envelope as seen in the figure below. The eight sections above the base also contain notches at each of the corners along the height of the inverted trapezoidal section. In order to parametrically control these components, they were created as individual conceptual masses with their various widths and heights as the driving parameters.  The notches in the eight upper sections are dependent on the overall outer and inner widths at the top and bottom of these sections and were also set as parameters. This will be described further in the following section. Once these conceptual masses were created they were loaded into a new total building family and essentially stacked on top of each other.

Figure 3: Schematic View (Sekavic 2005)

The components above the eight inverted trapezoidal sections were all created in the same manner using similar driving parameters since they all use the same basic trapezoidal form. For the components that are circular in form, they were created using either a revolve or sweep with driving parameters defined as radii and height. These were then uploaded into the full building family and placed in their appropriate places. The exterior façade of the building is composed of a rectangular curtain wall system which was created as a curtain wall by pattern mass family. The height and width of each window frame is controlled by the divide surface function in Revit, while the width and thickness of the frames are parametrically driven along with the materials for the frame and window pane. A separate curtain wall family that used the same parameters as the one previously explained was also created in order to easily change the color of the windows on the top edge of the tower base component and the upper eight inverted trapezoidal components. This is also described in further detail in the following section.

Parametric Modeling

Building Mass Model

The parametric mass model for Taipei 101 is composed of 22 conceptual masses stacked and aligned on top of one another. Of the 22 conceptual masses, there are 12 conceptual mass families with different shapes and dimensions that were used to create the full tower. Because most of these were created in the same manner, only a few of the main parametric building families are described in detail for clarity. The building families that make up the full tower family that are described can be seen in Figures 4 through 7 below and include: tower base component (component 1), the inverted and notched trapezoidal components that make up a majority of the tower’s height (component 2), the smaller main tower on top of the eight inverted trapezoidal sections (component 3), and the three trapezoidal sections on top of the smaller main top tower (component 4).

Figure 4: Component 1 Conceptual Mass

Figure 5: Component 2 Conceptual Mass

Figure 6: Component 3 Conceptual Mass

Figure 7: Component 4 Conceptual Mass

Parametric Modeling of Component 1

To create component 1 of the tower, the base of Taipei 101, the length and width of the base and the length and width of the top were defined as separate type parameters. The height was also defined as a type parameter. Once the length, width and height parameters were set to their respected values, a solid extrusion of this component was created. The driving parameters for this component are shown in Figure 8 below.

Figure 8: Component 1 Parameters

Parametric Modeling of Component 2

In order to create the parametric mass for component 2, the top and bottom faces were drawn using model lines to incorporate the notches in the corner edges. The top face of this component can be seen in Figure 9 below.

Figure 9: Top Face of Component 2

Once the top and bottom faces were drawn, the overall length and width of each face were defined as separate type parameters for both the bottom and top face. As can be seen from Figure 9 above, each side of the faces have four notches that make a diagonal cut in each of the four corners. In order to keep these notch lengths equal when the length and width of this component is changed, a parametric formula was defined for the notch width. The parametric formula for the notch width can be seen in Figure 10 below. With the notch width parametrically defined, the dimensions of the component can be changed while the notch lengths always remain equal to each other. Once all of these parameters were defined a solid extrusion between the top and bottom faces was created to create the form of component 2.

Figure 10: Component 2 Parameters

Parametric Modeling of Components 3 and 4

The parametric models of components 3 and 4 were created in the same manner as the parametric model for component 1. The base length and width, and the top length and width of each component were set as type parameters. The height of each component was also set as a type parameter. After these parameters were defined, again, a solid extrusion was used to create components 3 and 4. Figures 11 and 12 below show the parameters defining component 3 and 4.

Figure 11: Component 3 Parameters

Figure 12: Component 4 Parameters

As was previously mentioned, the remaining conceptual mass families were created in a similar manner to the ones just described. After all of the individual building components were created, they were all loaded into one single building family and stacked on top of each other. The families in which multiple components made up the full building were replicated the required number of times and placed in their respected positions. The total building conceptual mass family is shown in Figure 13 below.

Figure 13: Full Building Conceptual Mass Family

Façade Modeling

The façade of Taipei 101 is composed of a rectangular curtain wall system made up of steel frames and glass window panes. The parametric mass model of the curtain wall was created by using a curtain wall by pattern. The exterior window frame was created by using a rectangle with the sweep function to make the form of the frame around the entire rectangular window frame. The thickness and width of the frame element were assigned as parameters so that the frame and overall curtain wall appearance can be easily changed. The color and transparency of the glass along with the frame material was also assigned material parameters so that their colors can be changed quickly.  Figure 14 below displays the parametric conceptual curtain wall mass.

Figure 14: Parametric Curtain Wall Conceptual Mass

Once the conceptual mass of the curtain wall system was completed, the divide surface tool was used in the main building family so that the curtain wall system could be applied to the façade of the building. The number of rows and columns for the curtain wall grid was manually adjusted to make the building look as close as possible to the real one. The gold panels at the top of each component are a separate curtain wall conceptual mass that was created the same way as the main curtain wall system. This was done so that these panels could be assigned different materials and colors without changing the overall curtain wall pattern. Figure 15 displays what the curtain wall system looks like in the building mass family.

Figure 15: Curtain Wall System

Screen Shots of Parametric Families

Screen Shot 1 This screen shot was taken after the width and height parameters of the component of the tower were changed. The bottom width was made smaller, while the top width and height were made larger.

Screen Shot 2 This screen shot was taken after the width and height parameters of the mass family used to create the eight inverted trapezoidal sections were changed. The height and top width of this component were both drastically increased.

Screen Shot 3 This screen shot was obtained by changing the parameters of the components that make up the top spire portion of the tower. These were also height and width parameters. The components whose parameters were changed are the ones that look out of proportion to the rest of the building.

Screen Shot 4 This last screen shot was taken after the width and thickness parameters of the curtain wall system frame were changed. The frame width was dramatically increased. The color and material of the glass panes and the frame can also be changed, but were not for this screen shot.

Interior Modeling

Because the building very large and contains so many floor levels, a typical office floor plan was created. All of the exterior rooms are offices and conference rooms while most of the rest of the usable space is composed of work stations. The interior core of the building contains restrooms, elevators and stairs. These spaces are labeled, but no components were added due to time constraints. The typical office floor plan layout is shown in Figure 16 below.

Figure 16: Typical Office Floor Plan

Renderings

The figures below show the exterior and interior floor that was modeled of Taipei 101 in realistic renderings during the day.

Figure 17: Total Tower Exterior Rendering

Figure 18: Tower Top Exterior Rendering

Figure 2: Typical Office Floor Interior Rendering

Revit Modeling Issues/Comments

The main issue encountered when developing this model was creating a single curtain wall conceptual mass that would allow me to change the color and material of individual panels. I experienced this problem when I tried to change the color and material of the panels at the top of each building mass. I resolved this issue by creating a new curtain wall conceptual mass with different materials and colors. I then selected the individual panels that I wanted to change and changed the curtain panel type to the one I wanted. Although this is probably not the most sophisticated way to resolve the problem, the results were satisfactory and I believe that parametrically changing these panels is beyond the scope of this project. However, after methods for Revit programming is learned in the future, this problem will probably be able to be solved much more easily and quicker. I also had a few constraint issues when flexing the parameters of my building family, but they were easily resolved by locking and unlocking some of the alignments I created. 

Works Cited

Taipei Financial Center Corp. (2009). “Taipei 101,” <http://www.taipei-101.com.tw/en/Tower/index_tower.asp> (Feb. 23, 2012).

Sekavic, Daniel. (2005). “Taipei 101-Taipei Financial Center,” <http://www.daapspace.daap.uc.edu/~larsongr/Larsonline/SkyCaseStu_files/Taipei101.pdf> (Feb. 23, 2012).