Escolar Documentos
Profissional Documentos
Cultura Documentos
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.
...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.
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.
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.
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
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
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
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.
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.
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.
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
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
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
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
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.
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)
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
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.
Special $ Attributes
These $ with name area etc can be used as desired, but cannot be modified
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
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
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
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
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.
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:
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
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.
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 -
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
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
Note: *.bua file would save all attributes settings set in the Full Wizard - > Define At-
tributes and Formulas
7. BiMUp 5D - Project
7.1 Reports Folder / Output Folder
7.2 Styles Folder - *.bus
7.3 Attributes Folder - *.bua
7.4 Default Attributes
If you are using Roaming App Data - then the data will be shared across the net-
work\Documents
The folder can be changed as required by clicking Browse and navigating to the
preferred 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
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.
If_Set on Instance is checked, then the attribute value is set on the Component
Instance.
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.
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.
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
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
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
Tutorial Steps
Step 1 - Add two attributes:
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 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.
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.
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.
Enabling SketchUp Extensions describes how to enable and disable BiMUp Limited
add-ons using the SketchUp Extensions window.
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
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.
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
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.
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.
Then you have to create an attribute to use for the area. or for area * price per square
unit
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.
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.
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%
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.
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
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.
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
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
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.
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
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.
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.
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.
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.
This feature lets you define phrases which will be used to select components to in-
clude in your report.
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
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 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.
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
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
These time formats can be used in the report text of BiMUp 5D to provide better con-
trol of date and time.
Usage: %TM[format]% where format can contain arbitrary text, plus any of the follow-
ing:
%U Week of year as decimal number, with Sunday as first day of week (00 53)
%W Week of year as decimal number, with Monday as first day of week (00
53)
%x Date representation for current locale
%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