Options Management
SAPPHIRE™ Structure version 7.2.3, set for release in April, will contain an Options Manager.    This Options Manager will allow the ability to create and navigate Options within a single model.   Both individual Options changes and resolved model conditions can be designated and controlled by using the Options Manager to navigate active conditions.   The sections below describe the methods used for creating and navigating Options using the Options Manager within SAPPHIRE™ Structure.

Options Tree Creation

The Options Management system is located in the Job Tree.   The Options Management Tree is its own tree located below Levels and Layers in the Job Tree.

Options Tree Creation

The creation of the Options Tree is controlled by the context menu.  Once the Options category is selected in the Job Tree a right click will pull up the Options Context Menu.   The initial context menu will only display the Add Option/Category command.

The Add Option/Category command allows the user the ability to create an Option/Category at the same level as the currently selected Option tree item.  From the parent Options Tree setting the Add Option/Category automatically creates the Option/Category one level below the Parent.
If the Option/Category is selected in the Options Tree, the properties grid for the selected Option/Category is displayed.  Using the properties grid the Option/Category name can be changed to whatever is required.  Refer to the Inclusion/Exclusion section later in this article for more information on these settings in the properties grid.

If an Option/Category is selected and the right click command is used, the system will display the Options context menu.   In this menu the user can Active Option, Add Option/Category, Add Sub Option/Category, Move (Up/Down), and Delete. 

Active Option

The Activate Option command will make the selected Option the actively edited and viewed Option.  When an Option is activated entities added/removed from the model will be associated to that Option.


Add Option/Category

The Add Option/Category will create an Option/Category directly under the currently selected Option/Category.   If multiple Options/Categories are selected the system will create a multiple number of Options/Categories.  

Add Sub Option/Category

The Add Sub Option/Category will create an Option/Category nested below the currently selected Option/Category.   This type of Option/Category will be dependent on the parent option that it is nested under.   Changes made in the parent Option will be respected in the nested Options.  If multiple Options/Categories are selected the system will create 1 to n number of nested Sub Options/Categories.

Move Up / Move Down
The Move Up and Move Down commands will allow the ability to shift Options/Categories within the same level.  Nested options will move with the parent Option/Category. 


The Delete command in the Options Tree will delete the selected Option/Category and all nested Options/Categories.  A message will display indicating the names of all Options/Categories that will be deleted by the Delete command.  Users may select multiple  Options/Categories to delete at one time.

Options Navigation

A model with an Options Set can be navigated by activating the Option or Base Model.   Two forms of activation can be used.

Context Commands

The active Option or Base Model can be activated by right clicking on the desired level in the Options Tree and using the context commands to Activate Option.   The Active Option selection will make the currently highlighted Option active.  The Return to Base Model command will deactivate any currently active option and set the model to Base Model display.  

Double Clicking

The active Option or Base Model can be activated by double clicking either on the Options Category (activates Base Model) or double clicking on the desired Option (activates Option).   If an already active option is double clicked on the system defaults to the Base Model being active.

Options Display

There are two major methods of displaying an Option and the Base Model.  

Base Model

The display for the base model is the same as a common job that has no Options involved.

When the base model is active, the Options Category will display the text “(Active: Base Model)” after the Options Category name.

Active Option

The display for an active option changes the display of the model to focus on the activated Option/Category.    Entities that are specific to the Option/Category display as common model color and the entities that are not specific to the active Option/Category are set to a system Base Model color. 
When an Option is active, the active Option will display as bold on the Options Tree and the active Options name will display after the Options Category in the Options Tree.


Options Usage

Once an Option/Category is created in the job tree the Option/Category can be made active.  When this Option/Category is active the system will consider any deletions and additions made to the model based on the active Option model changes.   Any changes made directly to the Base Model/Parent entities will be experienced by all Options that contain that entity. 


Below is an example of the steps that can be used to create an Option. 

·         Activate the desired Option/Category.

·         Select the entities that will change or will be removed due to the active Option.  Delete the Base Model/Parent entities for cases of deletion. For cases of reuse (entity changes) use Cut and Paste for the entities in the Option.   Use a known location that doesn’t change due to the Option for the Cut and Paste reference point.

·         Change the desired members/junctions in the pasted entity.

Options Usage Helpful Hints

Below are a few helpful hints that can be considered when creating your Options/Categories.

·         If an entity is going to be reused in the current Option the Cut and Paste method is the quickest method to make the change.  You can Copy, Delete, and Paste but this adds an extra command.

·         If a modified condition was accidently made to the Base Model /Parent entities in a current active Option you can use undo to step this change out.

·         If a Base Model/Parent entity is no longer in the Base Model/Parent go to an Option with the desired entity and Copy and Paste it back up in the higher level.  Cleanup will be required for the entity in all downstream Options/Categories.

·         If the usage of planes is desired in the model it is best to reference planes to worklines since walls that planes are linked to can change drastically from Option to Option.

·         When a single Option is potentially used in multiple locations create the Options Tree to cover all the unique cases and use Copy and Paste to place the repeated objects in all the necessary Options.


Add and Remove Material Lists

Once an Option/Category is created the materials that are unique to that option can be displayed in the Options model.   Both the Added materials and the Deleted materials for each option are stored and can be recalled by Material List Generation.   


Options Material List Considerations

The Option Add and Remove Material Lists consider the following standard material list functionality.

·         Material list inclusion settings in Job Properties

·         Printing and export logic

·         Dynamic or manual material list updating

·         Material list movements and placements

·         The Base Model will create its material list the same as a none options model


Add and Remove Material List Creation

With an Option activated when the Create Material List is selected the system will trigger the creation of the Add and Remove material lists.   First the Add list will be considered followed by the remove list. 


Inclusion/Exclusion Logic

In the Option/Category properties not only can you change the name of the Option/Category but you can also create Option Inclusion and Exclusion considerations.


Inclusion/Exclusion Creation

When an Option/Category is selected the fields for Inclusion(s) and Exclusion(s) can be selected in the properties grid.   When these fields are selected, the Options Tree is displayed that allows the user the ability to set the desired Inclusions or Exclusions when the given Option/Category is selected for Site Specific creation.

For Inclusions, the system automatically includes any parent Option/Categories above the current selection.  For Exclusions the system automatically excludes and child Option/Categories below the current selection.   A single Option will have the counteracting command grayed out and italicized automatically in the Include/Exclude rules when the counteracting rule has been previously set.

For Inclusion/Exclusion logic gray italic indicates outside controlled rules, gray indicates controlled by selection in current dialog, red italic indicates conflicting rules, standard black indicates no rules currently applied.

Site Specific Creation

Once an Options model is complete the user then has the ability to create the necessary lot specific models for the given model.   This is considered the Site Specific Creation process.


Site Specific Process

With the parent Options category selected use a right click to pull up the context menu.  If any Options exist in the model, the context menu will contain the command Solve Site Specific.

Selecting the Solve Site Specific command will initiate the Site Specific Creation Dialog.   Within this dialog, the selections can be made that reference the Lot specific job.   When selections are made in the Site Specific Creation Dialog the Inclusion/Exclusion rules are automatically applied on selection.  Also the Site Specific Creation Dialog will automatically include parent selections on child Option/Category selection.   Grayed out italic indicates outside controlled settings, grayed out indicates setting based on current selections, red italic indicates conflicting rules, standard black indicates selectable Option. 

At the completion of the Site Specific selection set select the Site Specific button to save the Site Specific off to the desired location.   This saved Site Specific will be a unique model created based on the Options Model selection set.   This model can be modified and used the same as any stand alone job.

Upon Site Specific creation the Site Specific Creation dialog will reload in the Options Model to allow for quick multiple Site Specific creation.   Once Site Specific creation is complete use the Cancel button to exit the Site Specific Creation Dialog.


Site Specific Helpful Hints

Below are a few helpful hints for the creation of and modification of an existing Site Specific.

·         Make sure to avoid contradictory rules in Include/Exclude decisions per Option to avoid issues when creating Site Specifics.

·         If major changes are required in a newer version of the Site Specific return to the Options Model and export the new Site Specific with the desired Options.

·         If minor changes are required in a newer version of the Site Specific return to the Options Model and copy the needed Options.   Then paste those options into the existing Site Specific and update the model accordingly.  

·         Bundling and Truss Design should be done at the Site Specific level.  





 This page last modified on 4/14/2010