Home Services Projects Support Links Contact Us
Home Projects CSI Help
Printer friendly [PDF] (3.74MB)

Working with assemblies

Creating a new assembly

Open the database where the new assembly is to be created then do one of the following:

·         Click the New button on the main toolbar

·         Select File > New (or press Ctrl+N)

The Create new item window pops up (see figure 7). Select assembly and click the green check. A new assembly schematic like the one shown below opens.

Figure 12

Enter a name and comments as desired.

Note: CSI was designed to handle assemblies as documents (see earlier note on this), therefore, users must click the save button for the changes to be written to the database.

The embossed rectangle is the hydraulic schematic area where components and subassemblies may be entered to define a hydraulic circuit. The button labeled Chart opens the charting application for the current assembly.

The blank area immediately to the left of the chart button is used for special components that are required if an assembly is to be analyzed by the computation engine. (See Analyzing assemblies)

Opening existing assemblies

To open an existing assembly, first open the assembly listing by pressing the Assemblies button on the main database interface. The assembly-listing window is shown below:

Figure 13

The assemblies’ list may be filtered by creation date or last modification date.  Simply double-click the assembly row to open the assembly.

Adding new components to assemblies

To add a new component to an assembly, drag and drop the desired component icon from the component palette onto the hydraulic schematic area of the assembly. CSI creates a new blank component and opens the appropriate dialog box

Adding existing components to assemblies

Component definitions can be added to an assembly using one of the two methods described below:

·         Find (see finding components) and select the component definitions you want to include in the assembly then select the Copy option under the Edit menu or press Ctrl+C. Open the target assembly window (see opening assemblies). Click on the gray area of the hydraulic schematic to reset the current selection if required then select Paste under the Edit menu or press Ctrl+V. The selected components will be added to the assembly.

·         Open the target assembly window. Find and select the component definitions you want to include in the assembly. Notice the small black dot that appears to the top right of the leftmost-topmost selected cell. Manage both the assembly window and the component list window such that both the hydraulic schematic area and the aforementioned dot are visible on the screen. Place the mouse pointer directly on top of this black dot. The mouse will change shape as depicted on the figure below:

Figure 14

Click and drag the black dot (this is called the drag-drop handle) from the component list window onto the hydraulic are of the assembly window. While dragging, the mouse will change to according to the following rules:

·         If only one component is being dragged, it will show the type of component

·         If more than one component is being dragged, it will show the “sub-assembly” icon.

On systems with limited screen size where placing two screens side by side is difficult it becomes useful to start the drag-n-drop operation with the component list maximized. Having started the drag-n-drop operation, repeatedly press Alt+Tab until the desired assembly activates. The dragged selection can now be dropped onto the hydraulic schematic area of the assembly window.

Note: CSI uses three special types of components (fluid, document, and timing) in the assemblies that are to be analyzed (see running the analysis). Although these components are displayed by CSI in the gray area between the Name field and the Chart button, they too must be dropped onto the hydraulic schematic area of an assembly.

Adding components to an assembly from within.

Components may also be added from within the assembly. This is a useful feature if a component exists somewhere in the active assembly and must be used somewhere else within the same assembly. Instead of drag-n-dropping it or copy-n-pasting it from the component listing and re-entering project properties, the steps described below can be followed.

·         Open the assembly where the component is to be duplicated

·         Select the component or components that are to be duplicated (see selecting components/ assemblies/ logical links)

·         While holding both the control and shift keys down (Ctrl+Shft) click and drag the selected component(s) onto the gray area of the hydraulic schematic.

The following window appears:

Figure 15

Select whether you want to create copies or instances of the selected components (see next section)

An alternative method is:

·         Open the assembly where the component is to be duplicated

·         Select the component or components that are to be duplicated.

·         Select the Copy option under the Edit menu

·         Click anywhere on the gray area of the hydraulic schematic to reset the selection

·         Select the Paste option under the Edit menu

The window shown above appears. Select whether you want to create copies or instances of the selected components.

The next section provides a detailed explanation of the differences between copies and instances.

Creating component copies vs. instances

In order to describe the difference between creating copies and creating instances, the definition of an instance must be understood.

An instance is the collection of intrinsic properties of a component definition plus the collection of project related properties of a component, if any. Any time a component is added to an assembly from the components' palette or the components listing, an instance of that component is being created and project properties are associated with it. If the same component definition is added from the components’ listing, an additional instance of the same component is created, but both instances reference the same component definition. If an intrinsic property of the component definition is modified, the property will be modified in every instance in every assembly within the same database. 

For example, a tubing component definition is created with an outer diameter of 0.375 in and wall thickness of 0.049 in. The component is saved and instances of it are inserted in assemblies A, B and C with the following lines lengths assigned: 5 mi., 7 mi. and 4.5 mi. The tubing component definition is then opened from the components listing and its wall thickness is changed to 0.05 in. and saved. The next time assembly A, B, or C is opened, the tubing component will reflect the new wall thickness of 0.05 in.  The change of the wall thickness in the component list caused a change in all instances of the component.

In the picture below, the inner rectangles represent a tubing component definition (not all properties are shown) that has been inserted in one or more assemblies to create instances of said component.

 

 

 

 

 

 

Figure 16

If a duplicate component is created however (see duplicating components), a completely new component definition (detached from the original definition) will be created in the component list. Changing, an intrinsic property in one component will not change the properties in the other because they are separate components. In the picture below, the inner rectangle on the left represents a component definition that has been duplicated to create the component definition represented by the inner rectangle on the right. Changing intrinsic properties in the first component will not change intrinsic properties on the second component.

 

 

 

 

 

 

When a component definition is duplicated, a copy of the component is being created.

CSI detachment of intrinsic properties (directly associated with the component definition) from project properties (associated with an instance of a component definition) allows for an effective way to keep component definitions up to date.

Replacing assembly components

The Control Simulator GUI provides a way to quickly modify assembly configurations by dragging and dropping (or copying and pasting) components onto existing components. This feature is most useful when a single component or subassembly is to be replaced with another component or subassembly, but the user wants to preserve some properties. For example, consider a case where several hydraulic hoses are to be evaluated for a certain application. The user can create an assembly with all the logical links in place (for an explanation of logical links and how to set them up see Building the hydraulic circuit) and enter all the appropriate properties for all the hydraulic components, including the first hose being analyzed. The user can them duplicate the assembly (for an explanation of assembly duplication see Duplicating assemblies) instead of creating the second analysis case from scratch. Then rather than removing the original hose component, inserting the new one and reconnecting with logical links, the user can simply drag-n-drop the next hose component from the components listing onto the old hose component in the duplicate assembly. The hose component will inherit all the project properties (such as length) of the original hose component, but the instance will reference the newly dropped hose component. The process is depicted below:

           
   
    Right Arrow: Duplicate
 

 

 

 

 

 

 

 

 

Figure 17

The hose component H4 would replace the component referred to by H1b, effectively creating instance H4b, but the project properties (such as the length of the hose) of instance H1b would be inherited by instance H4b (for an explanation of instances see Creating instances vs. copies)

Note: To replace a component using the copy-n-paste procedure, first select the component that will replace the target component, then choose Copy under the Edit menu (or press Ctrl+C), then open the assembly where the target component is and select the component to replace. Now select Paste under the Edit menu.

Selecting components/subassemblies/logical links

In order to manipulate components within assemblies, the user must first make selections as appropriate. This section describes how components, sub-assemblies and logical links are selected in CSI. Because this section applies to components, sub-assemblies and logical links within an assembly, they all will be referred to as objects.  Selections may contain one or more objects.

Click an object to select it

Click an object while depressing the Ctrl key to add it to the current selection

Click an object while depressing the Alt key to remove from the current selection

CSI shows selected components and subassemblies with embossed icons. Logical links turn white when selected. The picture below shows a selected valve operator component.

Figure 18

The figure below shows a selected logical link. (For more information on logical links, see Building the hydraulic circuit)

Figure 19

Users can create selections in CSI by dragging a selection rectangle (selection rectangles do not apply to logical links). Simply click and drag with the left mouse button anywhere on the hydraulic schematic to begin a selection rectangle. Any component fully enclosed by the selection rectangle will be selected or deselected as explained below:

·         Click and drag resets the current selection and creates a new one. CSI displays the selection rectangle in black.

·         Click and drag while depressing the Ctrl key adds the enclosed components to the current selection. CSI displays the selection rectangle in blue.

·         Click and drag while depressing the Alt key removes the enclosed components from the current selection. CSI displays the selection rectangle in red.

In the image below, CSI will reset the current selection (the valve operator) and select the three components enclosed by the selection rectangle. It will select the valve operator and both restrictions at either side of the valve operator, but not the tubing component because the selection rectangle does not fully enclose it.

Figure 20

Editing assembly components

To edit properties of any component within an assembly, simply double click the component icon and enter properties in the resulting dialog box. Some components have project dependent properties, that is, properties that are not intrinsic to the component but potentially change from project to project such as the length of a hose of the precharge of an accumulator. In these cases, CSI requires the user to enter valid values for such properties.

Specifying component output options

CSI allows the user to specify which analysis variables to output. An output specification is always treated as a component project property. The image below shows the typical arrangement of an output specification control

Figure 21

·         Include:       The check box controls whether the variable is to be written to the output file or not.  The variable will be written only if the box is checked.

·         Unit spec.   Either type the unit to use for output or select the unit from the pop up menu that appears when the unit selector button (next to the units' spec) is pressed.

·         Precision:    Select the output precision with the pull-down list immediate to the right of the unit selector button.

Building the hydraulic circuit

The hydraulic circuit is defined by creating logical links between the assembly components (and sub-assemblies if applicable. For more information see using assemblies as building blocks).  To create the logical links follow the steps below:

·         Set CSI to "linking-mode" by holding down (continuously) the shift key.

·         Click near the desired component’s output port and drag while still holding the shift key down. CSI will find the closest output port and will create a "floating link" like the one by the mouse cursor shown below:

Figure 22

·         Continue dragging until the mouse is over the desired inlet port of the downstream component then release the mouse button.

·         Release the shift key

Logical links can only be created in downstream direction, i.e. beginning at an outlet port and ending on an inlet port. Outlet and inlet ports are to the right and left of the icon respectively. CSI shows the upstream portion of a logical link in red.

Copying assemblies across different databases

The steps for copying assemblies across databases are listed below:

·         Open the source database assembly listing

·         Open the target database assembly listing.

·         Select the assembly to be copied on the source assembly listing

·         Place the mouse over the drag-n-drop handle (the black dot at the top-left of the active cell), then click and drag with the left mouse button.

·         Drop the selected assembly onto the target assembly listing. CSI will copy the selected assembly along with all the dependent components. If the selected assembly included subassemblies, the entire assembly is “flattened-out”; that is, the components in the subassembly are brought into the same level as the top-level assembly.

Duplicating assemblies

CSI provides a way to duplicate assemblies. This feature becomes very useful in the following cases:

·         Different scenarios/cases are to be analyzed for a single assembly.

·         The user need to create an assembly that closely resembles an assembly that was previously defined in CSI

To duplicate an assembly, simply open the assembly listing, find the assembly you want duplicate and select it with a single click (double-clicking the assembly will cause CSI to open it). Right-click the selected assembly and select “duplicate” in the resulting pop up menu. The following dialog box appears:

Figure 23

Select whether you want to create copies or instances of the assembly components (and sub-assembly components if present) and click the check mark. If in doubt, create instances.  For more information on choosing component copies versus instances see Creating component copies vs. instances. For more information on subassemblies see Using component subassemblies to create complex assemblies.

Valid Assemblies (restrictions on component connections)

The assembly editor will allow you to construct almost any equipment arrangement you can think of.  However, the current computation engine (based on earlier versions of The Control Simulator) is restricted to certain predefined component arrangements.  These restrictions will eventually be removed, but, for now, you have to deal with them.

At the highest level, allowable arrangements must be of the form source -> line -> discharge.  Discharges may be followed by additional line -> discharge pairs for up to eight lines.  A line is simply tubing or a hose.  The source can be thought of as the equipment located topside.  The discharge is the equipment located subsea.  The source and discharge need further clarification.

Sources and discharges must be composed of components connected in certain predefined ways.  The following figures provide maps showing which components may follow other components.  In each figure, you must start with a component on the left edge of the figure (Having no line to the left of the box) and proceed to the right along the lines until you reach a component having no line to the right.

Text Box: Figure 24 – A structural error in an assembly

If you construct an arrangement that is not allowed, the assembly editor will give you an error message and a warning that the structure is not that of a valid assembly.  It also highlights the components that are in error.  In the example in Figure 25, a pressure source is followed directly by tubing.  If you look at Figure 26, you will see that a pressure source must be followed by a restriction, which may then be followed by tubing. 

 
 


To fix the error in Figure 25, you would delete the link between the pressure source and the line (click on the link to select it as in figure 19, and then press the delete key).  Then you would add a restriction to the assembly.  Finally, you would connect the pressure source to the restriction and then the restriction to the line.

 
  Text Box: Figure 25 - Map of allowable component connections at the source (topside equipment)

 

 

Figure 26 - Map of allowed component connections in the discharge (subsea equipment). Analyzing assemblies

Copyright © 2003 Oryx Software, Inc. All rights reserved