Vista CPD

Vista CPD
This container holds Analysis data for an instance of Vista CPD.

Methods

CreateBladeDesign

This command class creates a new BladeGen model. An up-to-date BladeGen cell appears on the project schematic containing the new model.

Return Container representing the BladeGen cell.
Type DataContainerReference

CreateGeometry

This command class creates a new BladeEditor model. An up-to-date Geometry cell appears on the project schematic containing the new model.

Return Container representing the Geometry cell.
Type DataContainerReference

CreateThroughflow

This command class creates a new throughflow system. The system, comprising Geometry, Setup, Solution and Results cells, is created on the project schematic and is updated performing the throughflow analysis automatically.

Optional Arguments

UseBladegen    Indicates whether to use a Bladegen cell or a BladeEditor(Geometry) cell
    Type     bool
    Default Value    False

CreateVoluteMesh

This command class creates a new pump volute geometry and mesh. An up-to-date Mesh system appears on the project schematic containing the new geometry and mesh cells.

Edit

This command class launches the Vista popup GUI.

GetVistaCPDBladeDesignProperties

This query takes a container reference and returns the Data Entity which contains user settings and properties for the VistaCPD Blade Design container.

Return Reference to the requested Data Entity
Type DataReference

Import

This command imports Vista data into the Blade Design cell from an existing BladeGen file. If no appropriate Vista data is found in the specified BladeGen file, an error message is generated.

    template1 = GetTemplate(TemplateName="VistaCPD")
    system1 = template1.CreateSystem()
    bladeDesign1 = system1.GetContainer(ComponentName="Blade Design")
    bladeDesign1.Import(FilePath="myfilepath/pump.bgd")

Required Arguments

FileName Name, and path, of the BladeGen file to be imported.
Type string

Data Entities

VistaCPDBladeDesign

This data entity provides access to the properties which define the VistaCPD project. This includes both the input and the results properties.

Properties

Alpha2

This property reports the absolute flow angle at the impeller trailing edge.

Type Quantity
Read Only Yes

AlphaIn

This property specifies the absolute flow angle, measured with respect to the tangential direction, at the leading edge of the pump impeller.

Type Quantity
Read Only No

AreaDiff

This property reports the volute diffuser exit area.

Type Quantity
Read Only Yes

AspectRatio

This property specifies the aspect ratio (height/width) of the rectangular volute cross section. This is valid when VoluteStyleOpt is 'Rectangular'.

Type float
Read Only No

B2

This property reports the hub to shroud distance at the impeller trailing edge (tip width).

Type Quantity
Read Only Yes

B3

This property reports the width of the volute inlet.

Type Quantity
Read Only Yes

Beta1

This property reports the relative flow angle at the impeller leading edge meanline section.

Type Quantity
Read Only Yes

Beta1Blade

This property reports the impeller leading edge blade angle at the meanline section.

Type Quantity
Read Only Yes

Beta1BladeHub

This property reports the impeller leading edge blade angle at the hub section.

Type Quantity
Read Only Yes

Beta1BladeHubUser

This property specifies the impeller leading edge blade angle at the hub, measured with respect to the tangential direction. This is valid when the HubBeta1Opt is set to 'User'

Type Quantity
Read Only No

Beta1BladeShr

This property reports the impeller leading edge blade angle at the shroud section.

Type Quantity
Read Only Yes

Beta1BladeShrUser

This property specifies the impeller leading edge blade angle at the shroud, measured with respect to the tangential direction. This is valid when the ShrBeta1Opt is set to 'User'

Type Quantity
Read Only No

Beta1BladeUser

This property specifies the impeller leading edge blade angle at the meanline, measured with respect to the tangential direction. This is valid when the HubBeta1Opt is set to 'User'

Type Quantity
Read Only No

Beta1Hub

This property reports the relative flow angle at the impeller leading edge hub section.

Type Quantity
Read Only Yes

Beta1Shr

This property reports the relative flow angle at the impeller leading edge shroud section.

Type Quantity
Read Only Yes

Beta2

This property reports the relative flow angle at the impeller trailing edge.

Type Quantity
Read Only Yes

Beta2Blade

This property specifies the blade angle at the impeller trailing edge, measured with respect to the tangential direction.

Type Quantity
Read Only No

BMExportOption

This property specifies whether the impeller is to be exported as an isolated impeller or coupled to a volute. The isolated impeller option provides for an extended exit diffuser to assist the analysis process. If the impeller is coupled to the volute, the exit diffuser is short to match with the volute inlet.

Available options:

Isolated

Coupled

Type ImpellerExportType
Read Only No

BMunitsOption

This property specifies the units used when creating a new BladeGen/BladeEditor model. Note that this is independent of the units used in the VistaCPD popup GUI.

Available options:

inches

Type BMunitsType
Read Only No

C2

This property reports the absolute flow velocity at the impeller trailing edge.

Type Quantity
Read Only Yes

Cm1

This property reports the meridional flow velocity at the impeller leading edge meanline section.

Type Quantity
Read Only Yes

Cm1Hub

This property reports the meridional flow velocity at the impeller leading edge hub section.

Type Quantity
Read Only Yes

Cm1Shr

This property reports the meridional flow velocity at the impeller leading edge shroud section.

Type Quantity
Read Only Yes

Cu1

This property reports the tangential flow velocity at the impeller leading edge meanline section.

Type Quantity
Read Only Yes

Cu1Hub

This property reports the tangential flow velocity at the impeller leading edge hub section.

Type Quantity
Read Only Yes

Cu1Shr

This property reports the tangential flow velocity at the impeller leading edge shroud section.

Type Quantity
Read Only Yes

Cu2

This property reports the tangential flow velocity at the impeller trailing edge.

Type Quantity
Read Only Yes

Cus

This property reports the slip velocity at the impeller trailing edge. This is defined as the difference between the theoretical 'no-slip' tangential flow velocity and the true tangential flow velocity.

Type Quantity
Read Only Yes

D1

This property reports the diameter of the impeller leading edge at the meanline section.

Type Quantity
Read Only Yes

D1Hub

This property reports the diameter of the impeller leading edge at the hub section.

Type Quantity
Read Only Yes

D1Shr

This property reports the diameter of the impeller leading edge at the shroud section.

Type Quantity
Read Only Yes

D2

This property reports the diameter at the impeller trailing edge meanline section (tip diameter).

Type Quantity
Read Only Yes

D2Opt

This property specifies the method used to set the impeller tip diameter. It may be calculated automatically, from a specified head coefficient or the value may be user defined.

Available options:

Automatic

HeadCoeff

User

Type TipDiamType
Read Only No

D2User

This property specifies the impeller tip diameter. This is valid when the D2Opt is set to 'User'.

Type Quantity
Read Only No

DEye

This property reports the impeller shroud diameter at the eye of the impeller.

Type Quantity
Read Only Yes

DEyeHub

This property reports the impeller hub diameter at the eye of the impeller.

Type Quantity
Read Only Yes

DiamDiff

This property reports the hydraulic diameter of the volute diffuser exit.

Type Quantity
Read Only Yes

DiamDiffUser

This property specifies the value of the volute diffuser exit diameter. This is valid when UserDiamDiff is set to true.

Type Quantity
Read Only No

DiffRatio

This property reports the diffusion ratio of the impeller.

Type float
Read Only Yes

DisplayText

The general property that defines the user-visible name of an entity. This property is defined for all data entities but is used only in those entities that present a label in the user interface.

Type string
Read Only No

DShaft

This property reports the impeller shaft diameter.

Type Quantity
Read Only Yes

EfficiencyOption

This property specifies how the impeller efficiencies are calculated.

With this set to 'Automatic' the efficiencies are calculated using empirical correlations. All other options require the specification of three of the efficiencies.The remaining value is calculated from those specified. For example, specifying 'Hydraulic' indicates that the hydraulic efficiency will be calculated and the volumetric, mechanical and overall pump efficiencies must be specified.

Available options:

Automatic

Hydraulic

Volumetric

Mechanical

Pump

Type EffType
Read Only No

FlowCoeff

This property reports the flow coefficient of the impeller.

Type float
Read Only Yes

Head

This property specifies the design point head rise for the impeller.

Type Quantity
Read Only No

HeadCoeff

This property reports the head coefficient of the impeller.

Type float
Read Only Yes

HeadCoeffUser

This property specifies the head coefficient, used to calculate the impeller tip diameter. This is valid when the D2Opt is set to 'HeadCoeff'.

Type float
Read Only No

HeightDiff

This property reports the volute diffuser exit height. In the case of a circular outlet, (elliptic volute cross section), this is the same as the hydraulic diameter.

Type Quantity
Read Only Yes

HubBeta1Opt

This property specifies the method used to set the impeller leading edge blade angles at the hub and meanline sections. These blade angles may be calculated relative to the leading edge blade angle at the shroud using either cosine or cotangent relationships, or they may be defined directly by the user.

Available options:

Cos

Cot

User

Type HubLEBetaType
Read Only No

HubInletDraft

This property specifies the impeller hub inlet draft angle. This is defined as the angle between the hub and the horizontal line at the hub inlet.

Type Quantity
Read Only No

HydEff

This property reports the hydraulic efficiency of the impeller.

Type float
Read Only Yes

HydEffUser

This property specifies the impeller hydraulic efficiency. This is valid when the EfficiencyOption is set to 'Volumetric', 'Mechanical' or 'Pump'.

Type float
Read Only No

Inc

This property reports the incidence at the impeller leading edge meanline section.

Type Quantity
Read Only Yes

IncHub

This property reports the incidence at the impeller leading edge hub section.

Type Quantity
Read Only Yes

IncShr

This property reports the incidence at the impeller leading edge shroud section.

Type Quantity
Read Only Yes

IncShrUser

This property specifies the angle of incidence for the impeller at the shroud. This is valid when the ShrBeta1Opt is set to 'Incidence'.

Type Quantity
Read Only No

Ks

This property reports the stability factor of the impeller.

Type float
Read Only Yes

LengthDiff

This property reports the volute diffuser axial length.

Type Quantity
Read Only Yes

LengthDiffUser

This property specifies the value of the volute diffuser axial length. This is valid when UserLengthDiff is set to true.

Type Quantity
Read Only No

MechEff

This property reports the mechanical efficiency of the impeller.

Type float
Read Only Yes

MechEffUser

This property specifies the impeller mechanical efficiency. This is valid when the EfficiencyOption is set to 'Hydraulic', 'Volumetric' or 'Pump'.

Type float
Read Only No

MerVelRatio

This property specifies the gradient of the velocity profile from hub to shroud at the impeller leading edge. The gradient is set using the ratio of the meridional velocity at the shroud leading edge radius to that at the average leading edge radius.

Type float
Read Only No

MinDiamFactor

This property specifies the shaft minimum diameter factor. This is a 'factor of safety' applied to the shaft minimum diameter as calculated from the maximum allowable shear stress of the shaft.

Type float
Read Only No

NPSHr

This property reports the net positive suction head required (NPSHr) of the impeller.

Type Quantity
Read Only Yes

Nq

This property reports the specific speed of the impeller using the European units system.

Type float
Read Only Yes

Ns

This property reports the specific speed of the impeller using the US units system.

Type float
Read Only Yes

Nss

This property reports the non-dimensional suction specific speed of the impeller.

Type float
Read Only Yes

NumVanes

This property specifies the number of impeller vanes.

Type int
Read Only No

OmegaS

This property reports the non-dimensional specific speed of the impeller.

Type float
Read Only Yes

PowShaft

This property reports the shaft power of the impeller.

Type Quantity
Read Only Yes

PumpEff

This property reports the overall efficiency of the impeller. This is the product of the hydraulic, volumetric and mechanical efficiencies.

Type float
Read Only Yes

PumpEffUser

This property specifies the impeller overall efficiency. This is valid when the EfficiencyOption is set to 'Hydraulic', 'Volumetric' or 'Mechanical'.

Type float
Read Only No

R3

This property reports the volute base-circle radius. This is defined as the distance from the centreline to the volute tongue.

Type Quantity
Read Only Yes

Rake

This property reports the lean angle at the impeller trailing edge (rake angle). Note that although this is also specified as an input property, the process to achieve the rake angle is iterative and may not always be achievable. In this situation there will be a difference between this value and that specified by the input property.

Type Quantity
Read Only Yes

RakeUser

This property specifies the blade lean angle at the impeller trailing edge (rake angle)

Type Quantity
Read Only No

Rho

This property specifies the density of the working fluid.

Type Quantity
Read Only No

RMajor

This property reports a list of the major radii of the elliptic volute cross sections. This is valid when VoluteStyleOpt is 'Elliptic'.

Type List<Quantity>
Read Only Yes

RMinor

This property reports a list of the minor radii of the elliptic volute cross sections. This is valid when VoluteStyleOpt is 'Elliptic'.

Type List<Quantity>
Read Only Yes

ShaftDiamRatio

This property specifies the shaft diameter ratio. This is defined as the ratio of the hub diameter to the shaft diameter. It is used to determine the hub diameter from the shaft diameter and size of the impeller fittings used to fix the impeller to the shaft.

Type float
Read Only No

ShrBeta1Opt

This property specifies how the impeller leadng edge blade angle at the shroud is set. With this option set to 'Incidence' the blade angle is calculated from the specified incidence, otherwise the blade angle is specified directly.

Available options:

Incidence

User

Type ShrLEBetaType
Read Only No

SlipRatio

This property reports the ratio of the slip velocity to the blade speed at the impeller trailing edge.

Type float
Read Only Yes

Speed

This property specifies the rotational speed of the pump impeller.

Type Quantity
Read Only No

Theta2

This property reports the angle of inclination to the horizontal of the impeller trailing edge, when viewed in the meridional plane.

Type Quantity
Read Only Yes

ThetaCR

This property specifies the volute casing rotation angle. This is defined as the angle between the vertical line and the tongue location when viewing the central section through the volute.

Type Quantity
Read Only No

ThetaDiff

This property reports the volute diffuser cone angle.

This is defined as the angle between the sloping sides of a circular based conic frustum, with the same inlet area, exit area and axial length as the volute diffuser.

Type Quantity
Read Only Yes

Thk

This property reports the impeller vane thickness.

Type Quantity
Read Only Yes

ThkRatio

This property specifies the ratio of the impeller vane thickness to the tip diameter. It is used in order to specify the impeller vane thickness in a non-dimensional manner.

Type float
Read Only No

TongueClear

This property reports the volute tongue clearance. This is defined as the volute base-circle radius minus the impeller tip radius.

Type Quantity
Read Only Yes

TongueThk

This property reports the thickness of the volute tongue ie. the tongue diameter at the cutwater.

Type Quantity
Read Only Yes

U1

This property reports the blade speed at the impeller leading edge meanline section.

Type Quantity
Read Only Yes

U1Hub

This property reports the blade speed at the impeller leading edge hub section.

Type Quantity
Read Only Yes

U1Shr

This property reports the blade speed at the impeller leading edge shroud section.

Type Quantity
Read Only Yes

U2

This property reports the blade speed at the impeller trailing edge (tip speed).

Type Quantity
Read Only Yes

UserDiamDiff

This property specifies that the volute diffuser exit diameter is to be defined by the user, rather than calculated automatically.

Type bool
Read Only No

UserLengthDiff

This property specifies that the volute diffuser axial length is to be defined by the user, rather than calculated automatically.

Type bool
Read Only No

VolA

This property reports a list of the volute cross sectional areas from cutwater to throat.

Type List<Quantity>
Read Only Yes

VolEff

This property reports the volumetric efficiency of the impeller.

Type float
Read Only Yes

VolEffUser

This property specifies the impeller volumetric efficiency. This is valid when the EfficiencyOption is set to 'Hydraulic', 'Mechanical' or 'Pump'.

Type float
Read Only No

VolFlow

This property specifies the design point volume flow rate delivered by the pump.

Type Quantity
Read Only No

VolHeight

This property reports a list of the height of the rectangular volute cross sections. This is valid when VoluteStyleOpt is 'Rectangular'.

Type List<Quantity>
Read Only Yes

VolR

This property reports a list of the radii of the centroids of the volute cross sections.

Type List<Quantity>
Read Only Yes

VolRouter

This property reports a list of the outer radii of the volute cross sections.

Type List<Quantity>
Read Only Yes

VoluteStyleOpt

This property specifies the volute cross section shape.

Available options:

Elliptic

Rectangular

Type VoluteType
Read Only No

VolWidth

This property reports a list of the width of the rectangular volute cross sections. This is valid when VoluteStyleOpt is 'Rectangular'.

Type List<Quantity>
Read Only Yes

W1

This property reports the relative flow velocity at the impeller leading edge meanline section.

Type Quantity
Read Only Yes

W1Hub

This property reports the relative flow velocity at the impeller leading edge hub section.

Type Quantity
Read Only Yes

W1Shr

This property reports the relative flow velocity at the impeller leading edge shroud section.

Type Quantity
Read Only Yes

W2

This property reports the relative flow velocity at the impeller trailing edge.

Type Quantity
Read Only Yes