You are on page 1of 106

BiM

Everyone
using
BiMUp
and
SketchUp
as a
BIM platform
www.BiMUp.co.uk
BiMUp for SketchUp

info@BiMUp.co.uk
BiMUp 5D
Manual

BiMUp 5D
for

Download BiMUp 5D at
http://www.BiMUp.co.uk/download/
BiMUp 5D - Manual Page 2
Revision 3
About BiMUp 5D
BiMUp Ltds first product, is called BiMUp 5D which directly relates to the day-to-day use
of BiM. It is simple, but quite remarkable, software that enables quantities to be taken
off any SketchUp model (The technicalities of this are contained in the product details
and demonstrated in the video presentations).

We have brought this to market because it is the crucial missing part of the jigsaw that
enables BiM using SketchUp to become a reality.
It means that cost-modelling can be auto-generated from the earliest design models
and that each time there is a change, the spreadsheets are also updated automati-
cally.

We are aware that this is quite a provocative step. It may mean that 95% of construction
projects can be BiM Compliant without the need for the expensive software, hardware
and training implications of the alternatives.

Because of the inherent adaptability of SketchUp and the millions of intelligent users,
we consider that it will only be a matter of time before the missing 5% is also covered.

Summary...
So, BiMUp Limited is focussed on construction, through its name and through its soft-
ware product, BiMUp 5D. But we do not see that as the end of the story, because we
think that SketchUp will increasingly be used to model all sorts of products and installa-
tions in other industries.

For that reason, BiMUp 5D will also be used as a quantifying tool on a widespread ba-
sis.

As John Bacus (SketchUp Project Manager) said about our ideas...

...I really like your use of the term day to day BIM. I think youre really onto some-
thing there. This is how buildings really get built.

SketchUp is a registered trademark of Trimble

Page 3 BiMUp 5D - Manual


Revision 3
About BiMUp Limited
The company was set up in 2012 to take a full part in the rapid changes occurring in
the construction industry and to seize the opportunities offered by the growing use of
SketchUp as a 3D modelling software.

All the directors have direct business experience in the construction and property sec-
tor as well as selling software to the construction professionals going back to the 90s.

Counter-Culture
We see great potential in the development and use of clever, simple and lower-cost
solutions to problems.
This is something that we have observed, and we think that there is a growing counter-
culture in this direction. This is not just a trend for smaller organisations who do not
have access to the same level of capital. It is increasingly taken up by larger companies
who want more speed and effectiveness from the deployment of their resources.

We have observed that there are many individuals and organisations engaged in new,
creative ventures, driven by the almost limitless horizon of possibilities that results from
technology. We think that current economic conditions (particularly in the West) will
mean that this energy is vital to the success of all sorts of commercial activity. This will
certainly not be limited to construction, but it is to that industry that we have given our
initial focus.

BiM for Everyone


Accordingly, BiMUp Limited is concerned directly with Building Information Modelling
using SketchUp as a platform.

We have made this commitment for a number of reasons but the primary source is
that we have been users ourselves. We have experienced the speed and functionality
of SketchUp. It is possible to model almost anything in 3D using the platform whole
buildings, the detail of a steelwork junction, etc. because we have done it. We have also
been checking what remarkable progress other people have made in SketchUp, par-
ticularly in the USA.

Of course there are other reasons which are less personal, for instance, is free, that
there are already millions of SketchUp users across different industries, that SketchUp
is an easy to learn, perfect tool to start the journey into the 3D modelling world, etc.

This is why we have had the confidence to claim that BiM can be achieved, in a way that
is straight-forward and successful, by using BiMUp and SketchUp.

BiMUp 5D - Manual Page 4


Revision 3
About BiMUp Limited Team

Gregory Malek MSc (Arch) ARB, RIBA, ICIOB


Gregory is responsible for all aspects of the BIM product and
the technical side of the project. His long track record in IT and
software implementation for professionals goes back to the
90s, where he was at the heart of the first BIM products like
MicroStation, ArchiCAD and ArchiTECH.PC. He has over 20 years
of experience using CAD systems.

He is also an Architect with extensive experience in project and


construction management acquired at the Top 100 worlds
largest multi-disciplinary architectural practice and through his
own construction company.

Deborah Malek MSc (Arch) ARB


Deborah has over 10 years experience in the construction in-
dustry and has been involved in a number of projects within the
Education, Commercial and Residential sectors with the em-
phasis on management.

She has been responsible for the delivery of multi-million pound


projects around London. Some of the tasks included process
co-ordination, making sure that projects are delivered on time
and within budget.

Her attention to detail, ability to tie all aspects of various projects,


successful conclusion, and her technical expertise are success-
fully applied in the BIM product.

Page 5 BiMUp 5D - Manual


Revision 3
Contents

1. BiMUp5D - Downloads and Installation11


1.1 Downloads and Installation
1.2 BiMUp 5D - Trial and Full Version
1.3 SketchUp Versions

2. BiMUp 5D - Introduction14
2.1 BiMUp 5D Toolbar
2.2 Attributes and Reports
2.3 Component Placement
2.4 Problems - Contact Us - Dont Give Up
2.5 First Steps

3. BiMUp 5D - Attributes 16
3.1 Pre-defined Attributes
3.2 Special $ Attributes
3.3 BiMUp 5D Bespoke Attributes
3.4 Dynamic Component Attributes

4. Attributes 16
4.1 Adding Attributes
4.2 Edit Attributes
4.3 Advanced Techniques

5. BiMUp 5D - Define Attributes  21


5.1 How to Define Attributes in BiMUp 5D using a CSV editor.

6. BiMUp 5D - Report Wizard23


6.1 Attribute Settings
6.2 Special Attributes
6.3 Metric and Architectural Calculations
6.4 Special Layers
6.5 Attribute Filters
6.6 Attribute Selection
6.7 Text Substitutions
6.8 PDF Text Formatting
6.9 PDF Page Layout
6.10 PDF Properties
6.11 Other Options
6.12 Context Menu
6.13 Other Buttons
6.14 BiMUp 5D Report Format

7. BiMUp 5D - Project 43
7.1 Reports Folder / Output Folder
7.2 Styles Folder - *.bus
7.3 Attributes Folder - *.bua
7.4 Default Attributes

8. BiMUp 5D - Set on Instance 46


8.1 Set on Instance is a setting for attributes in BiMUp 5D
8.2 Setting default values

BiMUp 5D - Manual Page 6


Revision 3
8.3 Setting Instance values

9. BiMUp 5D - Features 48
9.1 Assign Attributes to Components
9.2 Report on Dynamic Component Attributes
9.3 Create a Report or *.CSV file of Attributes in the model
9.4 Create a *.PDF Report
9.5 Save Attributes in SketchUp model for Component
9.6 Calculate Area
9.7 No Limit on number of Attributes
9.8 Include an image of the SketchUp model in the Report
9.9 Define Attributes based on size of Component instances
9.10 Calculate extended cost or total weight of Components
9.11 Perform calculations on Attributes
9.12 Filter Components for Report
9.13 Drill into Groups and Components for nested Components
9.14 Place multiple Attributes in a Report Cell
9.15 Add custom Report rows
9.16 Filter Components for Report
9.17 Assign Attributes to Components

10. BiMUp 5D - Advanced Features 56


10.1 Report Format
10.2 Number Formatting
10.3 Calculations and Substitutions
10.4 Pricing
10.5 PDF Properties
10.6 Filtering - specifying components to include in the report
10.7 List Attributes - displaying multiple attributes in a single cell
10.8 Define Attributes - define attributes for components in a CSV file
10.9 Custom Report Rows - adding calculations and additional information to report
based on component totals

11. BiMUp 5D - Advanced Techniques 56


11.1 Calculations - setting attribute values based on size of components, or other at-
tributes.
11.2 Area - report on the area of a face in a component.
11.3 Number Formatting - Database and Currency formatting
11.4 List Attributes - creating a list of sub-attributes
11.5 Filtering - filtering which attributes to include in report
11.6 Auto Generate Attributes - define and edit attributes in an excel spread sheet

12. BiMUp 5D vs SketchUp Report Features Comparison57


12.1 Overview
12.2 Main Differences

13. BiMUp 5D - Basic Features57


13.1 Report on Dynamic Component attributes
13.2 Add your own attributes and report on them
13.3 Define new attributes to be used in editing and reporting
13.4 Edit Attributes for components
13.5 Perform calculations on attributes

14. BiMUp 5D - Only Features57


14.1 Include an image of the SketchUp model in the report
Page 7 BiMUp 5D - Manual
Revision 3
14.2 Report on both Groups and Components
14.3 Define which attributes you want to include in your report
14.4 Combine and count components with similar attributes
14.5 Extend cost and other fields (multiply by quantity)
14.6 Total extended cost and other fields
14.7 Report of areas and volumes

15. BiMUp 5D - Advanced Features57


15.1 Define order and format of report columns
15.2 Use Excel with *.CSV file to define attribute values
15.3 Add custom report rows
15.4 Show multiple attributes in a single column

16. BiMUp 5D - Video Tutorials 64


16.1 BiMUp 5D - How to extend Total Weight
16.2 Tutorial Steps

17. SketchUp Versions 66


17.1 SketchUp 8
17.2 Reinstalling
17.3 Copying Files
17.4 Using multiple versions of SketchUp

18. BiMUp 5D - Enabling SketchUp Extensions67


18.1 SketchUp Extensions

19. BiMUp 5D - Calculations 68


19.1 BiMUp 5D Calculations are used to preset or calculate vales for Attributes
19.2 Substitutions
19.3 Substitution codes
19.4 Metric calculations
19.5 String Fields
19.6 Numeric Fields
19.7 Calculations
19.8 Ruby Code
19.9 Testing Calculations
19.10 Conditional Expressions
19.11 Default Values
19.12 Extended prices and costs
19.13 Extending length values
19.14 Advanced Techniques

20. BiMUp 5D - Area73


20.1 Specifying Faces to use for areas
20.2 Use Layer Name
20.3 Identify face in existing Component
20.4 How to use Area and cost per unit to create a Report
20.5 Attribute for Area
20.6 Cost per Square Meter
20.7 Cost of Component based on area
20.8 Combining Area and Area-Cost
20.9 Extending the area or area-cost by count
20.10 Final Report

21. BiMUp 5D - Number Formatting 82

BiMUp 5D - Manual Page 8


Revision 3
21.1 Available Formats
21.2 Database Formatting
21.3 Currency Formatting
21.4 Advanced Techniques

22. BiMUp 5D - List Attributes 84


22.1 BiMUp 5D List Attributes
22.2 Defining List attributes
22.3 Note the highlighted areas

23. BiMUp 5D - Custom Report Rows 86


23.1 BiMUp 5D Custom Report Rows
23.2 Calculations
23.3 Total Values
23.4 Calculated values
23.5 Formatting values
23.6 Adding report rows
23.7 More Help
23.8 Modifying the Ruby Script
23.9 Errors in the ruby script
23.10 Error messages
23.11 Ruby Console
23.12 Default Ruby Code

24. BiMUp 5D - Filtering92


24.1 Filter by layers and hidden geometry
24.2 Filter by selection
24.3 Filter using Skip_If and No_Drill
24.4 Skip_If attribute
24.5 No_Drill
24.6 Reversing Skip_If and No_Drill Attributes
24.7 Specifying Package Components
24.8 Filter using filter expressions
24.9 Advanced Techniques

25. BiMUp 5D - Auto Generate Attributes 100


25.1 Step-by-Step guideline

26. BiMUp 5D - Skip If using calculations102


26.1 Skip_If example using calculations

27. BiMUp 5D - PDF Properties103


27.1 Properties in BiMUp 5D Report Wizard
27.2 BiMUp 5D settings

28. BiMUp 5D - Time Formats105


28.1 Usage
28.2 Example

Page 9 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Manual Page 10
Revision 3
BiMUp 5D - Downloads and Installation

1. BiMUp5D - Downloads and Installation


1.1 Downloads and Installation
1.2 BiMUp 5D - Trial and Full Version
1.3 SketchUp Versions

Downloads and Installation


To download our Trial or Full Version of BiMUp 5D you would have to register at:
http://www.bimup.co.uk/download-menu/download/

After registration you would access a download link to our latest version of BiMUp
5D.
Single Click will start the download.
When the download is completed you would have to unzip the installation.
The unzipped file would allow you to install BiMUp 5D - double Click on the file
would start the installation - please follow the steps on your computer screen to
complete the installation.
Page 11 BiMUp 5D - Manual
Revision 3
BiMUp 5D - Trial and Full Version
The downloaded version of BiMUp 5D is limited to 14 Days, Fully Functional, Trial Ver-
sion.
If you would like to continue to work on BiMUp 5D, you would have to purchase a
Licence through our PayPal or Google Checkout at:
http://www.bimup.co.uk/buy/

After payment is made you will receive Licence Number which would require on-
line Validation/Authorization Code.

BiMUp 5D - Manual Page 12


Revision 3
BiMUp 5D - Online Licensing

To obtain the AuthCode you can Click the Check Licence and Validate button (you
have to be online) or if you encounter any problems with the process please send us
an email using Report Problem or Request AuthCode by Email .

Please note that, if you would try to Authorize a 2nd computer using the same licence,
BiMUp 5D would refuse to do so.

SketchUp Versions
When SketchUp releases a new version, you will need to reinstall your BiMUp Applica-
tions to use with the new version.

Page 13 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Introduction

2. BiMUp 5D - Introduction
2.1 BiMUp 5D Toolbar
2.2 Attributes and Reports
2.3 Component Placement
2.4 Problems - Contact Us - Dont Give Up
2.5 First Steps

BiMUp 5D add-on for SketchUp helps you define attributes, create reports on
SketchUp components.

BiMUp 5D is a very easy to use reporting software allowing for simple takeoffs such
as a count and cost of components drawn in a model or can provide the user with
sophisticated methods of calculations and conversions used in construction such
as volumes, areas, lengths multiplied by cost, rates or VAT.

The BiMUps 5D toolbar has three buttons:


About BiMUp 5D - general info about BiMUp 5D
BiMUp 5D Settings - all available settings are controlled from one location
BiMUp 5D Takeoff - all Reports can be generated each time using by a one click
of a button

Attributes and Reports


Report on Dynamic Component attributes
Add your own attributes and generate reports in CSV and PDF format
Count components
Add cost and multiply by quantities
Create own calculating formulas like you do in Excel

Problems - Contact Us - Dont Give Up


If you are trying BiMUp 5D for the first time, and have any problems, Dont Give Up.
We understand that sometimes something goes wrong. Combinations of Sketch-
Up versions, Windows versions and Computer types can cause unforeseen diffi-
culties. If you have the problems, Dont Give Up - contact us, we are here to help.
If you have problems with the download or installation - contact us, we are here
to help.
If the download doesnt start you can try again. Sometimes our download service
gets slow.

BiMUp 5D - Manual Page 14


Revision 3
If it still doesnt work please email us and we will send you a Direct Link to down-
load BiMUp 5D installation.
If you have other problems, or questions on how to use BiMUp 5D and you would
like to share them with others please put them on our Forum
BiMUp 5D Toolbar in SketchUp - If BiMUp 5D does not appear on the SketchUp
tool bar - please go and look under plugins. You should have BiMUp 5D entry
called Load BiMUp 5D . Please Click on it or you can restart SketchUp to trigger
the load.

Never Give Up, contact us at:


support@bimup.co.uk or
http://www.bimup.co.uk/forum-menu/forum/

First Steps
Added substitutions for lengths and volumes in metric and other units.
See Substitution Codes
Added additional, custom lines to report after total.
Use SketchUp 8 Volumes for %v% volume calculations.
Added a feature to extract attributes for all Components in a model, edit
them in Excel, reload them, and save the Components into a library.
Added No_Drill attribute setting to make components which should not be
drilled into

Page 15 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Attributes

3. BiMUp 5D - Attributes
3.1 Pre-defined Attributes
3.2 Special $ Attributes
3.3 BiMUp 5D Bespoke Attributes
3.4 Dynamic Component Attributes

4. Attributes
4.1 Adding Attributes
4.2 Edit Attributes
4.3 Advanced Techniques

BiMUp 5D Attributes come in four groups:

Pre-defined Attributes
These can be included and/or modified as desired.
Count - Components or Groups count
Cost - Cost of Components or Groups expressed in the local currency
Description - pre-set to Component name
Extended Cost - Count * Cost

Special $ Attributes
These can be used as desired, but cannot be modified
$area - return the area of the component in sq-inches (also, $area_sqft, $area_
sqm, $area_sqcm)
$count - a count of identical components - grouped into a single line
$comp_desc - the description stored on the component definition
$dname - returns the definition name
$iname - returns the instance name or blank if not set
$layer - the layer of the component
$level - return the sub-component level when drilling into sub-components (0 is
the top level)
$material - returns the Material Name on the Component Instance or Group
$name - returns the Instance name if set, if not the definition name (Up to any
# sign)
$path - return the drill path of Component names or group names

BiMUp 5D Bespoke Attributes


You can define own Attributes based on the Special $ Attributes or introduce be-
spoke values saved as BiMUp Ready Templates:

Feasibility - BiMUp Ready Template


Feasibility Study (Count/Name Units + GIA)
Gross Internal Area - GIA (m2 or ft2)
Net Internal Area - NIA (m2 or ft2)
Soft Landscape Area (m2 or ft2)
Hard Landscape Area (m2 or ft2)
BiMUp 5D - Manual Page 16
Revision 3
Car Parking Spaces - CPS (Count/Name)
Density (HR / ha)

Planning - BiMUp Ready Template


Gross Internal Area - GIA (m2 or ft2)
Net Internal Area - NIA (m2 or ft2)
Soft Landscape Area (m2 or ft2)
Hard Landscape Area (m2 or ft2)
Car Parking Spaces - CPS (Count/Name)
Density (HR / ha)
Kitchen (Count/Name + Volume)
Furniture (Count/Name)
Housing Quality Indicator - HQI

Construction - BiMUp Ready Template


Count/Name
Length (m or ft)
Area (m2 or ft2)
Volume (m3 or ft3)
Weight (kg)
Brickwork (Count/Name Bricks or Conversion to Area)
Blockwork (Count/Name Blocks or Conversion to Area)
Roof (Count/Name + Area)
Concrete (Count/Name + Volume)
Steel (Count/Name + Weight)
Insulation (Count/Name Volume or Conversion to Packs)
Windows (Count/Name)
Doors (Count/Name)
Lintels (Count/Name)
Partitions (Count/Name or Conversion to Sheets)
Services (Count/Name)
Specification (Count/Name + Links)
Gross Internal Area - GIA (m2 or ft2)
Net Internal Area - NIA (m2 or ft2)
Soft Landscape Area (m2 or ft2)
Hard Landscape Area (m2 or ft2)
Car Parking Spaces - CPS (Count/Name)
Photovoltaic Panel Area (m2 or ft2)

Please note:
All Templates can be converted to any units as required
If Millimetres (mm) are required you need to just multiply any formula by 1000
example: %w-m%*1000 or %d-m%*1000 etc

Dynamic Component Attributes


These are any attributes found in any Dynamic Components in your model. They
are preceded with DC for easy identification.

Some attributes, such as DC: lenx are set to the value of the nominal size in the
Dynamic Component, (e.g. _lenx_nominal). This is not necessarily the actual size of
the component, but is used to calculate the size of geometry in the component.
Page 17 BiMUp 5D - Manual
Revision 3
Adding Attributes

You can add additional BiMUp 5D attributes using the Add Attribute button. After
entering a name and clicking OK, the Edit Attribute dialog window will be loaded to
make changes.

BiMUp 5D - Manual Page 18


Revision 3
Edit Attributes

These are available on the attribute spreadsheet, and the Edit Attribute dialog.
Name - the name for your new Attribute
Header Text - the heading which will appear on reports
Minimum Width - the minimum width for Reports (In average character size)
Format - Text, Numeric, Database or Currency (See: Number Formatting)
Decimals - if Numeric, this is the number of decimal places to use
Extend From - calculate this field by multiplying another field by the Count field
Right Justify - Align text to the Right within table cell
Page 19 BiMUp 5D - Manual
Revision 3
Multi Line - attribute text contains carriage returns
Blank if Zero - report as blank when values is 0
Show Total - total this column
Skip if True - component is not displayed in report if this attribute is true
Do not Drill - do not drill into this component when processing sub0-compo-
nents
Is a List Box - attribute contains a list of sub attributes. See: List Attributes
Allow Report - Attribute is used for reporting
Allow Viewing - Will be viewed on the Edit dialog, but cannot be changed
Allow Editing - View and edit on the Edit Dialog
Suppress from Report - attribute is used to calculate other fields for the report,
but does not display directly on the report
Allow Substitutions - special fields, such as %l% for length, are replaced in at-
tributes
Set on Instance - attribute value is set on the Component Instance (You can set
a default value on the Component Definition)

Calculation String
Test Calculation - test the current calculation string
Add %attribute% to calculation - adds a reference to an existing attribute to
the calculation string
Calculation String - string to be calculated
List in Attribute - this attribute will be listed in the other attribute selected
Prev - save changes and navigate to the previous attribute
Next - save changes and navigate to the next attribute
Apply - save changes and reload (This is necessary if you change the type to
Numeric, and want to test numeric calculations)

BiMUp 5D - Manual Page 20


Revision 3
BiMUp 5D - Define Attributes

5. BiMUp 5D - Define Attributes


5.1 How to Define Attributes in BiMUp 5D using a CSV editor.

How to Define Attributes in BiMUp 5D using a CSV editor.


You can use a CSV file to Define Attributes for all the top level components in a
model. After setting the attributes, you can save the Component Definitions to disk
using the SketchUp Components Window. See the step-by-step guide below.

Page 21 BiMUp 5D - Manual


Revision 3
Step 1 - Place an instance of each component in a SketchUp model

Step 2 - Save the attributes for the components into a CSV file. Use Plugins/BiMUp
5D/Auto Generate Attributes to load the dialog, and click the Save cur-
rent attribute values to CSV button.

Step 3 - Define or change the attributes in Excel or an CSV file editor Either click
Yes to edit the file after the attributes are saved, or click the Edit CSV file
button.

Step 4 - Load the CSV file to set the new attributes onto the components. Click the
Load attributes from CSV file button.

Step 5 - After loading attributes - re-save your components into a library. Use Win-
dow/Components - Model/Save as a local collection

BiMUp 5D - Manual Page 22


Revision 3
BiMUp 5D - Report Wizard

6. BiMUp 5D - Report Wizard


6.1 Attribute Settings
6.2 Special Attributes
6.3 Metric and Architectural Calculations
6.4 Special Layers
6.5 Attribute Filters
6.6 Attribute Selection
6.7 Text Substitutions
6.8 PDF Text Formatting
6.9 PDF Page Layout
6.10 PDF Properties
6.11 Other Options
6.12 Context Menu
6.13 Other Buttons
6.14 BiMUp 5D Report Format

The BiMUp 5D Report Wizard creates reports for SketchUp Components, Dynamic
Attributes and other Attributes.

There are several tabs, plus some pop-up dialogs to define the report.

Page 23 BiMUp 5D - Manual


Revision 3
Attribute Settings

Click to Download and Open - BiMUp 5D Example 1


To calculate Basic Length using BiMUp 5D
https://3dwarehouse.sketchup.com/model.html?id=7718f9858b789e60ca24225aceed
2731
Click to Download and Open - BiMUp 5D Example 2
To calculate Basic Area using BiMUp 5D
https://3dwarehouse.sketchup.com/model.html?id=ad9bdd603d4555aca24225aceed
2731

BiMUp 5D - Manual Page 24


Revision 3
Click to Download and Open - BiMUp 5D Example 3
To calculate Basic Volume using BiMUp 5D
https://3dwarehouse.sketchup.com/model.html?id=5e0346fe071690a0ca24225aceed
2731
Load BiMUp Full Wizard to Define Attributes and Create Calculations Formu-
las
It would open the main window where all Attributes can be seen, added or edited as
required. It is the heart of BiMUp 5D where all formulas are set and used to calculate
various elements.
Quick Guideline about BiMUp 5D Attributes, Formulas and Various Calcula-
tion Techniques
It would open a window with a quick guide to the most used calculating elements.

Special $ Attributes
These $ with name area etc can be used as desired, but cannot be modified

$area - return the area of the element in sq-inches (in2)


$area_sqft - return the area of the element in sq-feet (ft2)
$area_sqm - return the area of the element in sq-meters (m2)
$area_sqcm - return the area of the element in sq-centimeters (cm2)
$count - a count of identical groups/components - all listed in a single row
$comp_desc - the description stored on the component definition
$dname - always returns the definition name (Components)
$name - always returns the instance name (Group) including name after # sign
$iname - returns the instance name, or would return blank if name is left blank
$layer - the layer of the component
$level - return the sub-component level when drilling into sub-components
(0 = is the top level, 1 = is the one level deeper)
$material - returns the Material Name on the Component Instance or Group
$path - return the drill path of Component names or group names

Metric and Architectural Calculations


Use %w% for width, %d% for depth, %h% for height, %a% for area, return values in
inches (in) even if you are using a different unit for your model in SketchUp units set-
tings Model info - Units

%w-m% will return a value in meters (m)


%w-cm% in centimetres (cm)
%w-f% in feet (ft)

Use %w-m%, %w-cm% and %w-f% for width (X axis in a Component)


Use %d-m%, %d-cm% and %d-f% for depth (Y axis in a Component)
Use %h-m%, %h-cm% and %h-f% for height (Z axis in a Component)
Use %a-m%, %a-cm%, %a-f% will calculate the area (Face in a Component or
Group)
Use %v-m%, %v-cm%, %v-f% will calculate the volume (Solid Component or
Group)

Page 25 BiMUp 5D - Manual


Revision 3
Special Layers
Use SketchUp layer name _BU_AREA for a quick area calculation

Please note:
If you place a face in the layer _BU_AREA within a component or group, it will use
that face (including scaling) to determine the area of the Component or Group

For more information visit our web page at:


http://www.BiMUp.co.uk

BiMUp 5D - Manual Page 26


Revision 3
Attribute Filters

Defined filters on which components to include in the report

Use filters to choose entities - when the option is selected BiMUp 5D would
start to filter selected attributes to be included or excluded based on a certain
conditions.
Ignore cases in filter expression - any wording in capital would be ignored
Match all filters - you can add up to 3 filters/conditions on which components/
groups are going to be filtered and included in the report. If all conditions are
met the component/group meeting your requirements is going to be included
in the Report

Page 27 BiMUp 5D - Manual


Revision 3
Match any filter - you can set up to 3 filters/conditions on which components/
groups are going to be included in the report - If minimum one condition is met
the component/group is going to be included in the Report
Top levels components only - the filter would look for the required keyword
through the top level Components
Note: Top level Component (level 0) it is the basic Component, which could have
nested Components inside. Any nested Components are treated as upper levels. 1st
nested Component within top level Component would be level 1. If nested Compo-
nent level 1 would have another nested Component, it would be at the level 2 count-
ed from the top level Component - level 0.

Working Example: Window with Glass and Ironmongery could have the following
levels structure
Level 0 = Top level Component = Window 800x1200
Level 1 Component = Window Frame
Level 1 Component = Window Cill External
Level 1 Component = Window Cill Internal
Level 1 Component = Glass
Level 2 Component = Stained Glass
Level 2 Component = Stained Glass Lead Frame
Level 1 Component = Ironmongery
Level 2 Component = Ironmongery Hinges
Level 2 Component = Ironmongery Lock

All components including sub-components - the filter would look for the re-
quired keyword through all levels of Components

BiMUp 5D - Manual Page 28


Revision 3
Filters for specific Attributes
Off - select from the list - the filter is Off
contains - the filter would look for the required keyword or part of a keyword
within a Component and include in the Report
does not contain - the filter would look for the required keyword or part of a
keyword within a Component and exclude from the Report
is precisely - the filter would look for the required full keyword/figure within a
Component and include in the Report
is not precisely - the filter would look for the close match keyword/figure within
a Component and include in the Report
is true - if condition is met within a Component it would include in the Report
is false - if condition is not met within a Component it would include in the Re-
port

Page 29 BiMUp 5D - Manual


Revision 3
Attribute Selection

It is a list all attributes which were marked as Allow on Report on the BiMUp 5D
Attributes spreadsheet.
Check All - checks all Attributes
Clears All Checks - removes checks throughout
Format - Loads a spreadsheet to determine the order of the Attributes in the
page, and set the format (e.g. number of decimal places) for each Attribute

BiMUp 5D - Manual Page 30


Revision 3
BiMUp 5D Report Format

The BiMUp 5D Report Format Wizard determines the order and other Attributes of
the columns in your Report.

You can drag the names of the Attributes in the header row left or right to change
the order of the report.

All Attributes listed in the table can be changed as required.

Page 31 BiMUp 5D - Manual


Revision 3
Text Substitution

The BiMUp 5D Substitutions Tab allows you to define your own substitutions for
use in BiMUp 5D reports for example, you can place text like:

%JOB% = Job Name or Job Number


%date% = Date
%TM[%X]% = Time
%REVISION% = Revision
%REVISED BY% = Revised by
in your report and then define JOB, REVISION, and REVISED BY on the substitutions
tab.
BiMUp 5D - Manual Page 32
Revision 3
Working Example:

Word %JOB% to be substituted with 424 Lee High Road, London


If you define a substitution called 424 Lee High Road, London (under Replace with
Phrase ZZZZ); then the word %JOB% have to be placed in the Text Substitutions Tab
(under Key %XXX YYYYYYY%) and subsequently in your Header and Introduction or
Body and Trailer box.

PDF Text Formatting

Page 33 BiMUp 5D - Manual


Revision 3
Specify text and font sizes for all aspects of the report
Report Header Font - this determines the size of the column headings for the
report
Report Fields Font - size of the report data. If your report does not fit properly
on the page, make this font smaller

PDF Text Formatting - Font


The BiMUp 5D Font Formatting window allows you to adjusted basic settings for
the
Report Title
Caption
Table Header Font
Table Body Font
The Available formatting is as follow
Font
Font Style
Font Size
Font Strikeout and Underline
Font Colour

BiMUp 5D - Manual Page 34


Revision 3
PDF Text Formatting - Edit

Page 35 BiMUp 5D - Manual


Revision 3
PDF Page Layout

Page Layout
Page Size - Letter, Legal, A3 or A4
Orientation - Portrait or Landscape

Page Margins
Margins - Adjust Top, Bottom, Left or Right margins as required

Page Images
Logo - Select your logo for the report and position against upper left or right
corner
BiMUp 5D - Manual Page 36
Revision 3
Clear - Removes Image/Logo
Height - Adjust the height of your Logo
Image for Report - If Model is selected - SketchUps Model View/Scene would
be visible or if Image is selected - any image can be inserted from the hard
drive
Height - Adjust the height of your Image
Background Image - If Included is selected, it would change the default white
background to selected image from the disk. Any image can be used, stretched
or tiled if required
Browse - Select Image/Logo from the disk

Page 37 BiMUp 5D - Manual


Revision 3
PDF Properties

These properties are stored internally in the PDF file and are available to the user
under mouse right click button and selecting Properties from the context menu.

BiMUp 5D - Manual Page 38


Revision 3
Other Options

Include components with no attributes - if checked, then all components


appear in the report - even if they have no Dynamic Component or BiMUp 5D
attributes
Combine components made unique or duplicated (# or copy in name) - if
checked then component names will be truncated before any # sign (for make
unique components), or before the word copy , (lower case and with spaces -
for duplicated pieces in Dynamic Components)
This will report components which have been: made unique on the same line if all
other attributes are the same. This will also report copied parts of dynamic compo-
nents as the same component.

Page 39 BiMUp 5D - Manual


Revision 3
Note: this may cause problems if you use a #-sign or the name copy in other com-
ponents.

Options
Selected Entities only - only report on selected components and groups.
Use filters to choose entities - this is not working yet.
Drill into sub-components level - report on sub-components and components
in groups up to this level. 0 = top level components only, 1 = drill one level deep,
2 = drill two levels deep and so on.
Takeoff Selected Entities only - it would included all selected objects and ig-
nore any not selected.
Show Totals - a total line is added to the .CSV file and Report to total columns
marked as Show Total.

Use Skip If Setting - use to skip components which have a Skip_if attribute set.
Drill, but do not report if set -
Do not drill or report if set -
Ignore - use all components -

Custom Report rows


Add custom rows after totals - it would add a custom row defined in the Ruby
Script. The default custom row is VAT.
Save or edit ruby data - would allow you to save and edit the default Ruby
Script which calculates VAT. You would have to edit the percentage rate if re-
quired as the default VAT rate is 17.5%
Load edited ruby data - would load the edited Ruby Script.
Reset to default - it would reset to the original Ruby Script with the pre-defined
VAT rate at 17.5%.

Startup Options
Use OpenGL for Place Symbol dialog - on some computers, and some video
boards, our Component Placement Wizard leaves artifacts on the SketchUp
drawing window. If this happens to you, check this box to turn of OpenGL pre-
viewing of components.
Load BiMUp 5D when starting SketchUp - it would load BiMUp 5D toolbar
automatically when ShetchUp is open
Put right click functions in sub menus - see the Print Screen below

BiMUp 5D - Manual Page 40


Revision 3
Context Menu
Select Component
Right Click - will show SketchUps Context Menu
BiMUp 5D Context Menu - see below

Other Buttons
Report Style - *.bus (b - bim, u - up, s - style)

*.bus file would save all settings made in the Attributes, Formatting and Other Op-
tions window including the name of *.PDF or *.CSV files

Report Attributes - *.bua (b - bim, u - up, a - attributes)

Note: *.bua file would save all attributes settings set in the Full Wizard - > Define At-
tributes and Formulas

Page 41 BiMUp 5D - Manual


Revision 3
Report File Name and Format

File Name - it is the name of the *.PDF and *.CSV files


Output Folder - will show the current saving path for *.PDF and *.CSV files
Show Takeoff Report when complete - launches the *.CSV file or *.PDF file
Make PDF name unique - it would make any *.CSV and *.PDF file name unique
to be sure that each generated report is kept
Generate and Save Takeoff as CSV file - saves the report information as a
*.CSV file which can be open and formatted in software reading CSV files for
example in MS Excel.
Generate and Save Takeoff as PDF file - saves the report information as a
*.PDF file which can be open in software reading PDF files for example in Adobe
Reader.

BiMUp 5D - Manual Page 42


Revision 3
BiMUp 5D - Project

7. BiMUp 5D - Project
7.1 Reports Folder / Output Folder
7.2 Styles Folder - *.bus
7.3 Attributes Folder - *.bua
7.4 Default Attributes

Reports Folder / Output Folder


If you do not set the BiMUp 5D Project Folder, then the default project folder is in
the Roaming App Data folder on your machine (e.g.: C:\Users\UserName\AppData\
Roaming\BiMUp_5D).

If you are using Roaming App Data - then the data will be shared across the net-
work\Documents

In our case the path was changed to C:\Users\Internet\Documents

The folder can be changed as required by clicking Browse and navigating to the
preferred folder.

Page 43 BiMUp 5D - Manual


Revision 3
Styles Folder - *.bus

If you do not set the BiMUp 5D Project Folder, then the default project folder is in
the Roaming App Data folder on your machine (e.g.: C:\Users\UserName\AppData\
Roaming\BiMUp_5D).

If you are using Roaming App Data - then the data will be shared across the net-
work\Documents

The folder can be changed by clicking Save and navigating to the preferred folder
where the report style (visual look) would be saved. Load would reload saved Style
from the hard drive.
BiMUp 5D - Manual Page 44
Revision 3
Attributes Folder - *.bua

If you do not set the BiMUp 5D Project Folder, then the default project folder is in
the Roaming App Data folder on your machine (e.g.: C:\Users\UserName\AppData\
Roaming\BiMUp_5D). If you are using Roaming App Data - then that data will be
shared across the network\Documents

The folder can be changed by clicking Save Created Attributes and Formulas and
navigating to the preferred folder where the Reports Attributes (formulas) would
be saved.

If new folders are set for holding settings, attributes and reports, BiMUp 5D would
use them as default and it would always read from them.

The saving option, each time allows to keep all common Attributes (with formulas -
*.bua), Styles (visual look - *.bus) and Reports in one central location or keep them
separately on project by project basis.

The other option is to keep all Attributes (with formulas - *.bua) in one central loca-
tion to allow all users to use them rather than set them individually each time.

If you want to use a network drive, just set the Project Folder to that network drive.

Default Attributes
Each SketchUp model would start to use the default BiMUp 5D Attributes:

Note: the default settings are only loaded once per SketchUp model. If a model al-
ready has BiMUp 5D attributes then the defaults are not loaded unless you load them
again.

Page 45 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Set on Instance

8. BiMUp 5D - Set on Instance


8.1 Set on Instance is a setting for attributes in BiMUp 5D
8.2 Setting default values
8.3 Setting Instance values

Set on Instance is a setting for attributes in BiMUp 5D

If_Set on Instance is checked, then the attribute value is set on the Component
Instance.

BiMUp 5D - Manual Page 46


Revision 3
Setting default values
You can also set a default value on the Component Definition.

If the user edits the Component Definition, an asterisk, (*), is shown next the attri-
bute title, to indicate that only the default value is being set. If a value of blank, or
0, is set on the Component Instance, then the default value will be used.

Setting Instance values

If some attributes have Set on Instance, then an extra right-click menu item - Edit
Instance Attributes is available. If you choose, Edit Instance Attributes, then only
the On Instance attributes will be shown.

If you select and right click on multiple instances or groups, you can set the values
for all of them at once. In this case, the current value will not be displayed on the
dialog.

Page 47 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Features

9. BiMUp 5D - Features
9.1 Assign Attributes to Components
9.2 Report on Dynamic Component Attributes
9.3 Create a Report or *.CSV file of Attributes in the model
9.4 Create a *.PDF Report
9.5 Save Attributes in SketchUp model for Component
9.6 Calculate Area
9.7 No Limit on number of Attributes
9.8 Include an image of the SketchUp model in the Report
9.9 Define Attributes based on size of Component instances
9.10 Calculate extended cost or total weight of Components
9.11 Perform calculations on Attributes
9.12 Filter Components for Report
9.13 Drill into Groups and Components for nested Components
9.14 Place multiple Attributes in a Report Cell
9.15 Add custom Report rows
9.16 Filter Components for Report
9.17 Assign Attributes to Components

BiMUp 5D - Manual Page 48


Revision 3
Assign Attributes to Components

Assign Attributes to Components


Attributes are stored
in Component defini-
tions.
If you have two in-
stances of a Compo-
nent and want dif-
ferent Attributes e.g.
location or inventory
tracking number - you
will have to create a
unique occurrence of
the Component.

Page 49 BiMUp 5D - Manual


Revision 3
Report on Dynamic Component Attributes

Report on Dynamic Component Attributes


You can view and Report
on Dynamic Component
Attributes. In order to
change Dynamic Compo-
nent Attributes you will
have to use the SketchUp
PRO Dynamic Component
editor

Create a *.PDF Report or *.CSV file of attributes in the model

Create a *.PDF Report or *.CSV file of attributes in the model


Create a Report from
Dynamic Components,
other Components using
BiMUp 5D Attributes, and
Groups with Attributes:
Select and order at-
tributes to be include
in the report
Report includes col-
lation and counting
of components with
similar attributes
Save Report Style to
the disk for re-use
Save Report Attributes
to the disk for re-use

BiMUp 5D - Manual Page 50


Revision 3
Create a PDF Report *.PDF

Create a PDF Report *.PDF


Report is stored in PDF
format so it can be eas-
ily placed on web pages,
printed or emailed to
clients

Save Attributes in SketchUp model and keep as Component

Save Attributes in SketchUp model and keep as Component


Attributes saved in the
definition are retained
when you export the
Components into a li-
brary
Can be used to pre-set
Attributes for Compo-
nent libraries or Trimble/
Google 3D Warehouse
Components
See our 3D models...

Page 51 BiMUp 5D - Manual


Revision 3
Calculate Area

Calculate Area
Using the $area At-
tribute, can calculate the
area of a face in a Group
or Component
Using the %a% in Calcu-
lation can calculate the
area of a face in a Group
or Component
Use SketchUp layer name
_BU_AREA for a quick
areas calculation. If you
place a face in the layer
_BU_AREA within a Com-
ponent or group, it will
use that face (including
scaling) to determine the
area of the Component
or Group

No Limit on number of Attributes

No Limit on number of attributes


No Limit on number of
Attributes
Use as many Attributes as
needed to generate your
Report
In BiMUp 5D you can
place multiple Attributes
in a single Report cell

BiMUp 5D - Manual Page 52


Revision 3
Include an image of the SketchUp model in the Report

Include an image of the SketchUp model in the report


Include an image of the
SketchUp model in the
Report

Define Attributes based on size of Component instances

Define Attributes based on size of component instances


Create multiple Report
definitions for multiple
Report formats
See: Substitutions

Calculate extended cost or total weight of Components

Calculate extended cost or total weight of Components


Create multiple report
definitions for multiple
Report formats.
See: Extended Prices
and Costs

Page 53 BiMUp 5D - Manual


Revision 3
Perform calculations on Attributes

Perform calculations on Attributes


Calculations based on
width, length or other
fields
See: Calculations

Filter Components for Report

Filter Components for Report


Filter selected Compo-
nents only, and also
using the Skip If True At-
tributes.
See: Filters

Drill into Groups and Components for nested Components

Drill into Groups and Components for nested Components


Drill into Sub Compo-
nents
See: Setup Tab
Filter selected Compo-
nents only, and also
using the Skip If True At-
tributes.
See: Filters
Using the Filter tab to
filter by any Attribute.
See: Filter by Expres-
sions

Place multiple Attributes in a Report Cell

Place multiple Attributes in a Report Cell


See: List Attributes

BiMUp 5D - Manual Page 54


Revision 3
Add custom Report rows

Add custom Report rows


By adding some ruby
code to your report defi-
nition, you can perform
calculations based on
totals and add additional
rows to the Report.
See: Custom Report
Rows

Filter Components for Report

Filter Components for Report


By adding some ruby
code to your report defi-
nition, you can perform
calculations based on
totals and add additional
rows to the Report.
See: Custom Report
Rows

Assign Attributes to Components

Assign Attributes to Components


By adding some ruby
code to your report defi-
nition, you can perform
calculations based on
totals and add additional
rows to the Report.
See: Custom Report
Rows

Page 55 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Advanced Features

10. BiMUp 5D - Advanced Features


10.1 Report Format
10.2 Number Formatting
10.3 Calculations and Substitutions
10.4 Pricing
10.5 PDF Properties
10.6 Filtering - specifying components to include in the report
10.7 List Attributes - displaying multiple attributes in a single cell
10.8 Define Attributes - define attributes for components in a CSV file
10.9 Custom Report Rows - adding calculations and additional information to report based
on component totals

11. BiMUp 5D - Advanced Techniques


11.1 Calculations - setting attribute values based on size of components, or other attributes.
11.2 Area - report on the area of a face in a component.
11.3 Number Formatting - Database and Currency formatting
11.4 List Attributes - creating a list of sub-attributes
11.5 Filtering - filtering which attributes to include in report
11.6 Auto Generate Attributes - define and edit attributes in an excel spread sheet

BiMUp 5D - Manual Page 56


Revision 3
BiMUp 5D vs SketchUp Report Features Comparison
This Report Features Comparison highlight the differences between the internal Sketch-
Up Pro Reporting feature and BiMUp 5D by BiMUp Limited.

12. BiMUp 5D vs SketchUp Report Features Comparison


12.1 Overview
12.2 Main Differences

13. BiMUp 5D - Basic Features


13.1 Report on Dynamic Component attributes
13.2 Add your own attributes and report on them
13.3 Define new attributes to be used in editing and reporting
13.4 Edit Attributes for components
13.5 Perform calculations on attributes

14. BiMUp 5D - Only Features


14.1 Include an image of the SketchUp model in the report
14.2 Report on both Groups and Components
14.3 Define which attributes you want to include in your report
14.4 Combine and count components with similar attributes
14.5 Extend cost and other fields (multiply by quantity)
14.6 Total extended cost and other fields
14.7 Report of areas and volumes

15. BiMUp 5D - Advanced Features


15.1 Define order and format of report columns
15.2 Use Excel with *.CSV file to define attribute values
15.3 Add custom report rows
15.4 Show multiple attributes in a single column

Page 57 BiMUp 5D - Manual


Revision 3
BiMUp 5D vs SketchUp Report Features Comparison
Overview

SketchUp Reports BiMUp 5D


Dynamic Component reporting uses BiMUp 5D is an add-on for SketchUp
the metadata embedded in your com- for defining attributes and creating
ponents to create tabular reports. reports from SketchUp components.
In SketchUp Pro, you can export BiMUp 5D can be very easy to use
detailed lists of every named entity for simple reporting - such as a count
and their corresponding attributes and cost of components placed in a
in either *.HTML or *.CSV format, for model. The report can be saved as a
use in your favourite spreadsheet ap- *.PDF file, or a *.CSV file.
plication. It also has very powerful features
- such as length, area and volume
calculations, which can create more
complex reports, but will also be a lit-
tle harder to use.

The Report Features Comparison highlight the differences between the internal
SketchUp Pro Reporting feature and BiMUp 5D by BiMUp Limited.

Main Differences

BiMUp 5D...
Works with SketchUp Free as well as SketchUp Pro
Reports on both Components and Groups
Combines similar components and adds a Count column
Create a PDF report with image and report data
Lets you order and format the report columns
Creates global attributes for all components
Totals fields on a special Total row
Lets you add custom report rows after the totals row

BiMUp 5D - Manual Page 58


Revision 3
BiMUp 5D - Basic Features
Report on Dynamic Component attributes

SketchUp Reports BiMUp 5D


Yes Yes - also reports on attributes you
add to ordinary components

Add your own attributes and report on them

SketchUp Reports BiMUp 5D


Yes - add attributes to Dynamic com- Yes - add new attributes for all com-
ponents. ponents in the model.

Define new attributes to be used in editing and reporting

SketchUp Reports BiMUp 5D


No - attributes names are extracted Yes - define the new attributes you
from Dynamic Components. want to use and they will apply to all
Attributes.

Edit Attributes for components

SketchUp Reports BiMUp 5D


Yes - right click on Dynamic Compo- Yes - right click on Component or
nent and change attributes. Group to change attributes, or extract
all Attributes into a *.CSV file and
change them on Excel.

Perform calculations on attributes

SketchUp Reports BiMUp 5D


Yes - using calculation in Dynamic Yes - uses DC calculated attributes
Component. and also additional calculations on
BiMUp 5D Attributes.

Page 59 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Only Features
Include an image of the SketchUp model in the report

SketchUp Reports BiMUp 5D


No Yes
Image of model and attribute report
and ability to customize report for-
mat.

Report on both Groups and Components

SketchUp Reports BiMUp 5D


No - Components only. Yes - Dynamic Components, other
components and groups.

Define which attributes you want to include in your report

SketchUp Reports BiMUp 5D


No - all attributes are reported Yes

BiMUp 5D - Manual Page 60


Revision 3
Combine and count components with similar attributes

SketchUp Reports BiMUp 5D


No Yes - similar components are consoli-
dated into a single report line. The
Count attribute is automatically cre-
ated and can be used for other calcu-
lations - such as extended cost, total
weight, etc.

Extend cost and other fields (multiply by quantity)

SketchUp Reports BiMUp 5D


No Yes - extend cost and other fields by
multiplying by the quantity or count.

Total extended cost and other fields

SketchUp Reports BiMUp 5D


No Yes - specify which fields you want to
create totals for.

Report of areas and volumes

SketchUp Reports BiMUp 5D


No Yes - use the areas of faces or vol-
umes of solids as attributes of in
calculations. See: Area and [[1]]

Page 61 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Advanced Features
Define order and format of report columns

SketchUp Reports BiMUp 5D


No Yes - you can define the format of
each column in the report - number
of decimal places, currency, etc. See:
Number Formatting
Yes - you can drag the names of the
attributes in the header row left or
right to change the order of the re-
port. See: Report Format

Use Excel or a *.CSV file to define attribute values

SketchUp Reports BiMUp 5D


No - all attribute values are stored in Yes - extract current and desired
the Dynamic Component attributes for all components into a
*.CSV file, edit it in Excel, and reload
into the Component Definitions.

Add custom report rows

SketchUp Reports BiMUp 5D


No Yes - add custom rows below totals,
using calculations based on the totals.

Show multiple attributes in a single column

SketchUp Reports BiMUp 5D


No Yes - To save room on the report, you
can combine attributes into a single
column.

BiMUp 5D - Manual Page 62


Revision 3
SketchUp Reports BiMUp 5D

Page 63 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Video Tutorials

16. BiMUp 5D - Video Tutorials


16.1 BiMUp 5D - How to extend Total Weight
16.2 Tutorial Steps

BiMUp 5D - How to extend Total Weight


BiMUp 5D - How to extend Total Weight - This tutorial shows how to add two attri-
butes - one for weight of each item, and one for Total Weight (weight times quantity).

Tutorial Steps
Step 1 - Add two attributes:

Step 2 - Weight Each and Total Weight

Step 3 - Use the Add Attribute on the BiMUp 5D Attributes Wizard to add two at-
tributes

Step 4 - Here I have made them decimal and specified one decimal place

Step 5 - Close the Attributes dialog

Step 6 - Before setting the Weight Total to extend from the Weight Each, you must
close and reopen this dialog. Otherwise Weight Each will not show up in the
list of fields to Extend from.

BiMUp 5D - Manual Page 64


Revision 3
Step 7 - Reopen the BiMUp 5D Attributes Wizard and set Weight Total to extend from
Weight Each

Step 8 - Click the Extend from column for Weight Total and select Weight Each.

Step 9 - Also set Weight Total to total - check the total column, so you will get a total
of the weight for all columns.

Step 10 - Create Report - Now the Weight Total should extend properly in the report by
multiplying Weight Each by Qty.

Page 65 BiMUp 5D - Manual


Revision 3
SketchUp Versions

17. SketchUp Versions


17.1 SketchUp 8
17.2 Reinstalling
17.3 Copying Files
17.4 Using multiple versions of SketchUp

When SketchUp releases a new version, you will need to reinstall your BiMUp prod-
ucts to use the new version (Or you can copy some files from the old SketchUp plugins
folder to the new folder).

SketchUp 8
SketchUp 8 incorporated a new version of Ruby which requires that you will need to
install new versions of most BiMUp applications. You can download the latest version
from:
http://www.bimup.co.uk/download-menu/download/

Reinstalling
The cleanest way to do this is to:
Uninstall the application. This will remove the old version of BiMUp from SketchUp.
Re-install it selecting the new SketchUp location.
If you uninstall and reinstall, then when you install later upgrades, they will install into
the proper version of SketchUp.

Copying Files
Copying files is much easier. However if you ever install a new version of SketchUp
it will continue to install any plugins folders into the old SketchUp location. The new
SketchUp Plugins folder will be in a path something like:
C:\Program Files (x86)\Google\Google SketchUp 8\Plugins
There may be no (x86) if you do not have a 64-bit machine
The path may be different depending on where you installed SketchUp
The old SketchUp Plugins folder will be in a path something like:
C:\Program Files (x86)\Google\Google SketchUp 7\Plugins
C:\Program Files (x86)\Google\Google SketchUp 6\Plugins

We would always insist for the old version of BiMUp products to be unistalled and
new fresh version to be installed where the latest version of SketchUp is.

Using multiple versions of SketchUp


If you want to run BiMUp products in more than one version of SketchUp, then you
should uninstall/reinstall the application into the latest version of SketchUp, and then
copy the files to the older version.

BiMUp 5D - Manual Page 66


Revision 3
Enabling SketchUp Extensions

18. BiMUp 5D - Enabling SketchUp Extensions


18.1 SketchUp Extensions

Enabling SketchUp Extensions describes how to enable and disable BiMUp Limited
add-ons using the SketchUp Extensions window.

What is a SketchUp Extension?

A SketchUp Extension is like any other Ruby script, except for the fact that you make
a few extra code calls to tell SketchUp that its an extension, which means that users
can easily turn it on or off by clicking a checkbox under the:
SketchUp Preferences > Extensions menu
Extensions make it easier for end users to manage all of their applications.

When you install a BiMUp Limited add-on, it is automatically added to the SketchUp
Extensions list, and automatically set to load automatically whenever you load Sketch-
Up.

Add-ons can be activated and deactivated via SketchUps extension manager. If you
dont see the add-on on your toolbar, ensure that the application is enabled under:
Window > Preferences > Extensions in SketchUp

Page 67 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Calculations

19. BiMUp 5D - Calculations


19.1 BiMUp 5D Calculations are used to preset or calculate vales for Attributes
19.2 Substitutions
19.3 Substitution codes
19.4 Metric calculations
19.5 String Fields
19.6 Numeric Fields
19.7 Calculations
19.8 Ruby Code
19.9 Testing Calculations
19.10 Conditional Expressions
19.11 Default Values
19.12 Extended prices and costs
19.13 Extending length values
19.14 Advanced Techniques

BiMUp 5D - Manual Page 68


Revision 3
BiMUp 5D Calculations are used to preset or calculate values for Attributes.
Examples:

Step 1 - Set an Attribute equal to a standard size - e.g. the X-width of a Component.
e.g: %w% - (See Substitutions below)
Step 2 - Set an Attribute to a constant value - to be used in other calculations or for
display.
e.g. 3.14159, or: File.basename(Sketchup.active_model.path)
Step 3 - Calculate an Attribute based on the value of other Attributes.
e.g. %length% * %cost_per_foot% / 12.0

Substitutions
In the fields marked for substitution (Substitutions = y), you can enter values which
will be replaced by the size of the component. This is done by using special codes,
such as %w% in the description.

Substitution codes
%w% - is replaced by the width of the component
%d% - is replaced by the depth of the component
%h% - is replaced by the height of the component
%z% - is replaced by the minimum z-height of the component
%a% - is replaced the area of a face in the component. See: Area
%v% - is replaced the volume for closed solids or by the product of width, depth
and height for objects which are not closed solids
%n% - is replaced by the name of the instance or component

Metric calculations
%w%, %d% and %h% - return values in inches even if you are using a different
unit for your model
%w-m% - will return a value in meters, %w-cm% in centimeters, and $w-f% in feet
Use %d-m%, %d-cm% and %d-f% for depth
Use %h-m%, %h-cm% and %h-f% for height
%v-m% will calculate the volume in cubic meters, %v-cm% will calculate the vol-
ume in cubic centimeters, and %v-f% will calculate the volume in cubic feet
%v-m% is the same as %v%/61023.744095 (We use the SketchUp calculation VOL-
UME/(1.0m * 1.0m * 1.0m) to convert from cubic inches to cubic meters)
%a-m% will calculate the area in square meters, %a-cm% will calculate the area in
square centimeters, and %v-f% will calculate the area in square feet. We use the
area of a face in the Component. See: Area
Note: The string which receives the substitutions is the value stored on the Component.

Page 69 BiMUp 5D - Manual


Revision 3
Samples
String Fields
This lets you use a generic description for several Components, which will be modified
by the actual size of the Component.
e.g.: %w% x %d% table will appear on reports as: 36 x 48 1/2 table
For width, depth, or height substitutions, you can also add an amount, in inches,
which you would like to add or subtract from the actual size. e.g. %w - 3.0 will sub-
tract 3 from the width.

Numeric Fields
You can use %w% or other values to set or calculate a numeric.
%w% - will be replaced by the width of the component
%w% - 3.0 will be replace by the width less 3.0

Calculations
Fields may be calculates based on values in other fields.
Use %field% to represent the value from another field.

Ruby Code
Calculations are executed using Rubys eval() command. You may use any phrases
which are available in Ruby.
Floating point numbers must be preceded by a 0. For example, if you want to
calculate a 17.5% tax, use a calculation like: %Base Price% * 0.175

BiMUp 5D - Manual Page 70


Revision 3
Testing Calculations

There is a Test button for calculations on the edit attribute definition wizard.

The output shows the substitutions it makes to perform the calculation, the final ruby
command, and the value after using it.

The 0s on each line are a level - for instance if a calculations uses another calculated
field, it will show how that field is calculated as well.

If you select a component or group, before loading the attribute editor, it will perform
the calculations on that item. Otherwise it uses the first component or group found in
the model.

Conditional Expressions
Ruby has a format, using ? and : to base a calculation on whether an expression is true
of false.
%length% > 180 ? 0.35 : 0.25
A conditional expression returns the value of either the expression before or the
expression after the colon, depending on whether the logical expression before the
question mark evaluates to true or false. In this case, if the length is greater than
three, the expression returns 0.35. For shorter items, it returns 0.25.

Page 71 BiMUp 5D - Manual


Revision 3
Default Values
If the calculation string starts with DEF:, then the value will only be applied the first
time, or if the current value is blank. Examples:
DEF:Enter Description - will cause the value Enter Description to be placed in the
field if not other values has been entered
DEF:%n% - will cause the component name to be entered into the field if not other
values has been entered

Extended prices and costs


To include extended prices or costs in your report:
1. Add an additional field, e.g. Extended Cost.
2. Set the new field to total
3. Set the original cost field not to total.
4. Define extend_from for the extended cost field.

Extending length values


1. Define a field equal to the length, e.g. length with the substitution value %w%
2. Define a second field, to extend by length, e.g. cost_per_foot
3. Define a third field, to be the extended cost, e.g. cost with the calculation value:
%length% * %cost_per_foot%
You can also do this without creating the length attribute if you do not need to show
it:
1. Define a field, to extend by length, e.g. cost_per_foot
2. Define a second field, to be the extended cost, e.g. cost with the calculation value:
%w% * %cost_per_foot%

Advanced Techniques
Calculations - setting attribute values based on size of components, or other at-
tributes
Area - report on the area of a face in a component
Number Formatting - Database and Currency formatting
List Attributes - creating a list of sub-attributes
Filtering - filtering which attributes to include in report.
Auto Generate Attributes - define and edit attributes in an excel spread
sheet.

BiMUp 5D - Manual Page 72


Revision 3
BiMUp 5D - Area

20. BiMUp 5D - Area


20.1 Specifying Faces to use for areas
20.2 Use Layer Name
20.3 Identify face in existing Component
20.4 How to use Area and cost per unit to create a Report
20.5 Attribute for Area
20.6 Cost per Square Meter
20.7 Cost of Component based on area
20.8 Combining Area and Area-Cost
20.9 Extending the area or area-cost by count
20.10 Final Report

Page 73 BiMUp 5D - Manual


Revision 3
Specifying Faces to use for areas
BiMUp 5D Area is a calculation which allows you to specify a face in a component for
use in area calculations.

Use Layer Name


Place the face in a special layer: If you place a face in the layer _BU_AREA within a
Component or Group, it will use that face (including scaling) to determine the area of
the Component or Group

Identify face in existing component


To define and use areas for a component:
1. Add a new attribute, and use %a% in its calculation (Or %a-m% for square meters,
%a-cm% for square centimeters or %a-f% for square feet.

BiMUp 5D - Manual Page 74


Revision 3
2. After placing your component in a model, right click on it and select Define Area
3. Select a face in the component to be used as the area.
Note: This feature will only work if a single face in the component can be used to calcu-
late the area.

How to use Area and cost per unit to create a report


Area is especially complicated because we have to have a face to calculate the area of.
You can define the face to use for area in one of two ways:

See Example1 below

Specifying Faces to use for areas


See Example2 below

Page 75 BiMUp 5D - Manual


Revision 3
Attribute for Area

Then you have to create an attribute to use for the area. or for area * price per square
unit

BiMUp 5D - Manual Page 76


Revision 3
To create an attribute called, area:
1. Create a new attribute (e.g. area)
2. Set it as numeric and set the number of decimal places desired.
3. Set its calculation as %a-m% - meaning area in square meter.

Cost per Square Meter

If the cost per square meter is fixed for the entire project, then you can use a constant
value. If it is different for different components, then you will need to create an attri-
bute for it and enter a value for each component.

Page 77 BiMUp 5D - Manual


Revision 3
After creating the attribute, you can right click on each component to set the cost.

BiMUp 5D - Manual Page 78


Revision 3
Cost of component based on area

1. Now create a new attribute - which will be the area times cost-per-m2
2. Set the calculation to: %cost-per-m2% * %area%
3. Note the drop down box above the calculation area makes it easy to copy and paste
the required %attribute% formats
4. Click on it to bring up a list of attributes to use in the calculation.

Combining Area and Area-Cost


In this example I used one attribute for area, and a second attribute for area cost.

I could have used just one attribute - area cost - by including the %a-m% in the calcu-
lation string:
Use: %cost-per-m2% * %a-m% - instead of - %cost-per-m2% * %area%

Page 79 BiMUp 5D - Manual


Revision 3
Extending the area or area-cost by count:
(Not you cannot use %count% in a calculation. Extensions can only be done using a
Extended attribute.

Create a new attribute for the extended area-cost (area-cost * quantity)

BiMUp 5D - Manual Page 80


Revision 3
Final Report
I included all the variables in the report. (This is a good idea during testing) You could
suppress some of them from the report later if they are not needed)

Page 81 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Number Formatting

21. BiMUp 5D - Number Formatting


21.1 Available Formats
21.2 Database Formatting
21.3 Currency Formatting
21.4 Advanced Techniques

Available Formats:
Text - value is treated as text
Numeric - value is numeric - no units conversions are performed. You may specify
the number of decimal places desired
Database - value is edited and displayed in the current SketchUp units and format
Currency - value is edited and displayed based on your Windows international set-
tings

Database Formatting

Database values are edited and displayed in the current SketchUp units and format.

The values are stored internally as inches, so you can change units and/or your clients
can use your components with other units settings.

BiMUp 5D - Manual Page 82


Revision 3
Currency Formatting
Currency Formatting is determined by the Windows Region and Language Settings.

Advanced Techniques
Calculations - setting attribute values based on size of components, or other at-
tributes
Area - report on the area of a face in a component
Number Formatting - Database and Currency formatting
List Attributes - creating a list of sub-attributes
Filtering - filtering which attributes to include in report
Auto Generate Attributes - define and edit attributes in an excel spread sheet

Page 83 BiMUp 5D - Manual


Revision 3
BiMUp 5D - List Attributes

22. BiMUp 5D - List Attributes


22.1 BiMUp 5D List Attributes
22.2 Defining List attributes
22.3 Note the highlighted areas

BiMUp 5D List Attributes


BiMUp 5D List Attributes allow you to display more than one attribute value in a table
cell.
This feature is only available in BiMUp 5D Pro - This allows you to display more attributes
without making the table too wide.

In this example, LenX, LenY and Name are all displayed in a single cell called list.
Note: that LenX and LenY are totaled at the bottom of the report.

BiMUp 5D - Manual Page 84


Revision 3
Defining List attributes
The attribute column to display the list must have is_list checked.
The attributes to display in the list attribute, bust have list_in set to the name of the list
cell.
(In this example we called the list cell list. It could have had a different name)

Note the highlighted areas:


list:
has Total checked to created totals for this column
has is_List check to specify that this column will contain other attributes.
DC: LenX and DC: LenY:
have Total checked so they will be included in the total.
have Suppress checked so they will not appear on the report as separate col-
umns.
have List_in set to list - the name of the attribute they are displayed in
DC: Name
does not have Total checked, because it does not make sense to total this at-
tribute.
Note on totals:
The totals in this example are not done properly. To create the totals proper-
ly, DC: LenX and DC: LenY would need to have been extended into another at-
tribute bymultiplying them by the count, and the new attribute would need
to have been used for the list cell and the totals.

Page 85 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Custom Report Rows

23. BiMUp 5D - Custom Report Rows


23.1 BiMUp 5D Custom Report Rows
23.2 Calculations
23.3 Total Values
23.4 Calculated values
23.5 Formatting values
23.6 Adding report rows
23.7 More Help
23.8 Modifying the Ruby Script
23.9 Errors in the ruby script
23.10 Error messages
23.11 Ruby Console
23.12 Default Ruby Code

Here is a sample report with VAT added:


(Ignore the $ signs - the currency signs, and decimal point symbol are determined by your
Windows settings)
The Total row was added by the report. The VAT and Total Cost rows were added by the
ruby
script, based on the calculated total cost.

BiMUp 5D Custom Report Rows


By adding some ruby code to your report definition, you can perform calculations
based on totals and add additional rows to the report.

Calculations
See the Default Ruby Code below for examples.

Total Values
You can set a ruby variable equal to a value on the totals row, using the name of the
column. (not the description). e.g.:
total_cost = total_row[extended_cost] # replace extended_cost with the name of your
extended_cost column

BiMUp 5D - Manual Page 86


Revision 3
To make sure that it is treated as a floating point value, add: .to_f (this helps if you
have misspelled the column name).
total_cost = total_cost.to_f # make sure this has a value if nil

Calculated values
You can calculate new values, based on the total values:
vat = total_cost * 0.175

Formatting values
You can use the ruby command sprintf(sformat, value) to format numbers, e.g. (to
display a value with 2 decimal places)
svalue = sprintf(%.2f, vat) # format to two decimal places
There is also a command to add currency symbols and international formatting for
decimal points:
svalue2 = dll_call_format_currency(svalue) # add currency formatting

Adding report rows


You add a report row by giving it a description, ( passed to start_custom_row() ), and
by setting values in the columns you want to set.

The basic format for this is:


custom_row = start_custom_row(Description)
custom_row[extended_cost] = svalue
add_custom_row
A similar format can be used to add divider rows:
custom_row = start_custom_row(----------) # start a new custom row with dashes in the
description line
custom_row[extended_cost] = ---------- # add a divider line in extended_cost column
add_custom_row

More Help
If you add trace commands to the ruby code, they will display on the ruby console
when the report is generated. This can be very helpful while debugging:
trace(TOTAL COST: %s, total_cost)
trace(VAT: %s, svalue2) # display on ruby console
For otther help, add a discussion to our Help Forum.

Page 87 BiMUp 5D - Manual


Revision 3
Modifying the Ruby Script

The custom cuby script is saved in your SketchUp model. If you want to make changes
to it, you can save a copy on disk, edit it, and reload it into the model.
Save or edit ruby data - after clicking this button, the location of the saved ruby
data (in a .txt file), will be displayed and you can edit it in a ASCII editor

BiMUp 5D - Manual Page 88


Revision 3
Load edited Ruby data - after editing the ruby script, you need to reload it and
save it back into the model.
Reset to default ruby data - this resets the ruby script saved in the SketchUp
model to the default Default Ruby Code.

Errors in the ruby script


Here I have made an intentional error in the ruby script.

In the line after getting the total cost, I have calculated a salesmans commission, but
misspelled commission on the next line when calculating the new_total.
#get total_cost
total_cost = total_row[extended_cost] # replace extended_cost with the name of your
extended_cost column
total_cost = total_cost.to_f # make sure this has a value if nil
trace(TOTAL COST: %s, total_cost)
#there is an error in the second line below
commission = total_cost * 0.25
new_total = total_cost + comision # misspelled

Error messages
When running the report, I get an error message like this:

Note: that the line number is displayed in the error to help you find it and fix it.

Page 89 BiMUp 5D - Manual


Revision 3
Ruby Console
Also, if you open the Ruby Console, before starting you report, the traces (e.g. :
trace(TOTAL COST: %s, total_cost)
will be displayed and the error message will be reported on the ruby console.

Here is some of the ruby console output for this script:


ADD CUSTOM ROWS
TOTAL COST: 0.0
ERROR during add_custom_rows: undefined local variable or method `comision for
#<BiMUp 5D:0x95a0e70>
CUSTOM ROWS:36:in `add_custom_rows
AFTER ADD CUSTOM ROWS
(The phrases ADD CUSTOM ROWS and AFTER ADD CUSTOM ROWS are displayed be-
fore and after your script is called).

Default Ruby Code


# ruby file to generate custom report data
# copyright 2011 BiMUp Limited Systems
# For use with BiMUp 5D
# for documentation see:
# replace extended_cost with the name of your total cost column.
# calculate new values and add to new rows.
def add_custom_rows
trace(ADD CUSTOM ROWS) # traces are displayed on the ruby console.
#get total_cost
total_cost = total_row[extended_cost] # replace extended_cost with the name of
your extended_cost column
total_cost = total_cost.to_f # make sure this has a value if nil
trace(TOTAL COST: %s, total_cost)
# calculate VAT from total cost
vat = total_cost * 0.175
# add a divider line in extended_cost column
# custom_row is a hash array. You can add values to if for any attributes included in

BiMUp 5D - Manual Page 90


Revision 3
the report
# start a new custom row
# ---------- will appear in the name or description column
custom_row = start_custom_row(----------) # start a new custom row
custom_row[extended_cost] = ---------- # add a divider line in extended_cost column
# add the custom row to report
add_custom_row
# display VAT calculation
custom_row = start_custom_row(VAT) # start a new custom row
svalue = sprintf(%.2f, vat) # format to two decimal places
svalue2 = dll_call_format_currency(svalue) # add currency formatting
trace(VAT: %s, svalue2) # display on ruby console
custom_row[extended_cost] = svalue2 # this adds the currency value to the extend-
ed_cost column
add_custom_row # add the custom row to report
# add a divider line in extended_cost column
custom_row = start_custom_row(===========) # start a new custom row
custom_row[extended_cost] = =========== # add a divider line in extended_cost
column
add_custom_row # add the custom row to report
# display new total cost
custom_row = start_custom_row(Total Cost) # start a new custom row
svalue = sprintf(%.2f, vat + total_cost) # format to two decimal places
svalue2 = dll_call_format_currency(svalue) # add currency formating
custom_row[extended_cost] = svalue2
add_custom_row # add the custom row to report
end#def

Page 91 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Filtering

BiMUp 5D Filtering is used to determine which components or sub-components


should be included in the report.

24. BiMUp 5D - Filtering


24.1 Filter by layers and hidden geometry
24.2 Filter by selection
24.3 Filter using Skip_If and No_Drill
24.4 Skip_If attribute
24.5 No_Drill
24.6 Reversing Skip_If and No_Drill Attributes
24.7 Specifying Package Components
24.8 Filter using filter expressions
24.9 Advanced Techniques

Filter by layers and hidden geometry


Components which are not visible are not included in the report.

Filter by selection
The setting Selected Entities only on the Report Setup tab will report only on entities
which are selected in the SketchUp model.

BiMUp 5D - Manual Page 92


Revision 3
Filter using Skip_If and No_Drill
Skip_If attribute

Marking the new attribute - NoShow - as Skip_if.


Note: This attribute is marked to as Allow Report so that it is used to calculate the report.
But is also marked Suppress from Report so it does not show up on the report.
If you have an component which you never want to include in a report, you
can mark it as Skip_If.
If Skip If is set for an attribute and the attribute is true, then the component
will not be included in the report.
If the Skip If attribute is calculated, then the result of the calculation will be
used.
If it is Numeric, Database, or Currency, then it will be skipped if the values is
non-zero.
If if is Text, then it will be skipped if it is not blank.

See: Skip If using calculations

Page 93 BiMUp 5D - Manual


Revision 3
The attribute NoShow is marked as Skip_If. If it is checked for a component, then that
component is not included int the report.

BiMUp 5D - Manual Page 94


Revision 3
No_Drill

Setting the attribute called NoDrill as No_Drill.

Note: This attribute is marked to as Allow Report so that it is used to calculate the report.
But is also marked Suppress from Report so it does not show up on the report.

If you have items which you want to count when placed individually, but do not want
to count when placed in a package or container, then you can mark the package
containing the items as No_drill and the components within the package will not be
counted.

If an attribute is marked as No_Drill and that attribute is true for a component, then
that component will not be drilled into to look for other attributes.
Page 95 BiMUp 5D - Manual
Revision 3
The attribute called NoDrill is marked as No_Drill in the Attribute Setup Wizard, andthe
value for NoDrill is checked for the components which should not e drilled into.

Reversing Skip_If and No_Drill Attributes


Some time you may want to mark only those items you dont want to Skip, or mark
only those items you do want to drill.

This is done by creating a second attribute, e.g. DoShow, and using it to calculate the
NoShow attribute.
DoShow is a Boolean Attribute and you set it for the items to include in the
report.
NoShow is also a Boolean Attribute. Its Calculation is set to: !%DoShow% -
this will set NoShow to true when DoShow is false. Mark NoShow as Skip_if
so that items for which NoShow is true, (because DoShow is false), will not be
included in the report.

Attribute Skip_if Calculation


DoShow not set
NoShow set !%DoShow%
others not set

BiMUp 5D - Manual Page 96


Revision 3
Specifying Package Components
You can use similar logic to specify Package components, which should be drilled, but
not shown on the report.
Create a new attribute - Package - and set it to true for those items which
should be drilled, but not reported.
Create a new attribute - NoDrill - mark it as No_Drill, and set is to calculate
as: !%Package% (NoDrill will be true for all components for which Package is
false)
Also mark Package as Skip_If. Components with Package set to true will be
drilled into, and not shown on the report.

Attribute Skip_if No_Drill Calculation


Package set not set
NoDrill not set set !%Package%
others not set not set

Page 97 BiMUp 5D - Manual


Revision 3
Filter using filter expressions

This feature lets you define phrases which will be used to select components to in-
clude in your report.

BiMUp 5D - Manual Page 98


Revision 3
For example, to create a wall report you could:
1. Define an attribute, Type, which would contain the word Wall for walls.
2. Set the filter to include components only when the attribute Type contains the word
Wall
For a Door and Window report, you could use similar filtering.
Use filters to choose entities
If checked, then only component and groups whose attributes match the filter will be
used for reporting.
Ignore case in filter expressions
If checked, then the case of values is ignored, e.g. Wall, wall, and WALL would all match
the filter value wall.
Process Components which:
Match all Filters
only items which match all filters will be processed.
Match any filters
items which match any filter will be processed.
If you need other options, then you can create dummy attributes, based n calcula-
tions, which will be can be used for more complex filtering.

Apply filter to:


Top level components only
If a Top level component is selected, then any sub-components will be processed as well.
(Assuming you are drilling into sub-components.)
All components (including sub components)
The filter is applied to everything. If a top-level component is filtered out, then its sub-
components will not be processed either.
Filters
Attribute
Select one of the report attributes from the drop down list.
Condition
ignore - do not use this filter
contains - contains the filter phrase anywhere in the attribute value.
does not not contain - Does not contain the phrase.
is precisely - the filter phrase must exactly match the attribute value.
is not precisely - the filter phrase does not exactly match the attribute value.
is true - a Boolean attribute is true
is false - a Boolean attribute is false

Advanced Techniques
Calculations - setting attribute values based on size of components, or othe at-
tributes
Area - report on the area of a face in a component
Number Formatting - Database and Currency formatting
List Attributes - creating a list of sub-attributes
Filtering - filtering which attributes to include in report
Auto Generate Attributes - define and edit attributes in an excel spread sheet

Page 99 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Auto Generate Attributes

Autogenerate Attributes is a feature of BiMUp 5D to make it easier to define attributes


for your components.

25. BiMUp 5D - Auto Generate Attributes


25.1 Step-by-Step guideline

If you want to save, or distribute a library of components with attributes already as-
signed, you can use this feature to easily define the attributes for components, and
then save the component definitions into a library.

Step 1 - After you define your attributes you can create an empty *.csv file for your at-
tributes using Auto Generate Attributes from the Plugins/BiMUp 5D menu.

Step 2 - Click Save Current Attributes to CSV

BiMUp 5D - Manual Page 100


Revision 3
Step 3 - Click Yes to edit the attributes, or click Edit CSV File

Step 4 - After editing the attributes in Exel, click Load Attributes from CSV File to
reload the new attributes.

Step 5 - A message will be displayed showing how many components were updated

Step 6 - Test the update by right clicking on one of the components to view/edit its
attributes.

Step 7 - Load the SketchUp Components Window, select model, and save all the com-
ponents in your model to a local collection

Step 8 - When you place components from this collection, they should have the at-
tributes already assigned to them.

Note: BiMUp 5D requires that each component name be unique. If you have components
in different folders with the same name, you will need to rename them in order to make
them unique.

Note: Also, because of a bug (or feature) in SketchUp, you cannot create new, unique,
*.SKP files by copying another *.SKP file. If you have two components with exactly the
same geometry, you need to load the component in SketchUp and use Save As to create
the second component. Otherwise SketchUp and BiMUp 5D will be confused about which
of the two identical components is which.

Page 101 BiMUp 5D - Manual


Revision 3
BiMUp 5D - Skip If using calculations

26. BiMUp 5D - Skip If using calculations


26.1 Skip_If example using calculations

Skip_If example using calculations


In this example, we have one attribute, skip_if which is set to inactive (using the at-
tribute editor) for components, or sub-components we do not want to include in the
report.

See the row called skip_if and the Attribute Settings below:

skip_if
is a Boolean attribute
has Skip_If checked
It can be set to inactive using the Attributes Editor

BiMUp 5D - Manual Page 102


Revision 3
BiMUp 5D - PDF Properties

27. BiMUp 5D - PDF Properties


27.1 Properties in BiMUp 5D Report Wizard
27.2 BiMUp 5D settings

PDF Properties in BiMUp 5D Report Wizard

PDF Properties in BiMUp 5D sets settings for the Properties dialog of Adobe Reader.
Hide Toolbar - specifies whether the toolbar bar will be visible in Adobe Reader
Hide Sidebar - specifies whether the sidebar will be visible in Adobe Reader

Page 103 BiMUp 5D - Manual


Revision 3
Document Properties in Adobe Reader

BiMUp 5D - Manual Page 104


Revision 3
BiMUp 5D - Time Formats

These time formats can be used in the report text of BiMUp 5D to provide better con-
trol of date and time.

28. BiMUp 5D - Time Formats


28.1 Usage
28.2 Example

Usage: %TM[format]% where format can contain arbitrary text, plus any of the follow-
ing:

Symbol Stands for...


%a Abbreviated weekday name

%A Full weekday name

%b Abbreviated month name

%B Full month name

%c Date and time representation appropriate for locale

%d Day of month as decimal number (01 31)

%H Hour in 24-hour format (00 23)

%I Hour in 12-hour format (01 12)

%j Day of year as decimal number (001 366)

%m Month as decimal number (01 12)

%M Minute as decimal number (00 59)

%p Current locales A.M./P.M. indicator for 12-hour clock

%S Second as decimal number (00 59)

%U Week of year as decimal number, with Sunday as first day of week (00 53)

%w Weekday as decimal number (0 6; Sunday is 0)

%W Week of year as decimal number, with Monday as first day of week (00
53)
%x Date representation for current locale

%X Time representation for current locale

%y Year without century, as decimal number (00 99)

%Y Year with century, as decimal number

%z, %Z Either the time-zone name or time zone abbreviation, depending on regis-
try settings; no characters if time zone is unknown
%% Percent sign

Page 105 BiMUp 5D - Manual


Revision 3
Examples
%TM[%b %d %Y %X]%
Dec 31 1998 20:00:00

%TM[%a on %b %d, %Y, %X time zone: %Z]%


Wed on Jan 25, 2006, 11:32:10 time zone: W. Europe Standard Time

BiMUp for SketchUp Team


SketchUp is a registered trademark of Trimble

BiMUp 5D - Manual Page 106


Revision 3

You might also like