Vista RTD

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

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

Edit

This command class launches the Vista popup GUI.


GetVistaRTDBladeDesignProperties

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

Return     Reference to the requested Data Entity
    Type     DataReference

ImportBladeGen

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

VistaRTDBladeDesign

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

Properties

AFR

This property specifies the air/fuel ratio of the working fluid. This is only available when using the AFR option for GasProps.

Type     float
Read Only    No
Alpha2

This property reports the absolute flow angle at the impeller inlet.

Type     Quantity
Read Only    Yes
Alpha2User

This property specifies the absolute flow angle at the impeller leading edge. Note that this is not available when the InletOption is set to 'Calculated'.

Type     Quantity
Read Only    No
Alpha3

This property reports the absolute flow angle at the impeller exit station.

Type     Quantity
Read Only    Yes
Alpha3User

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

Type     Quantity
Read Only    No
Beta2

This property reports the relative flow angle at the impeller inlet.

Type     Quantity
Read Only    Yes
Beta2User

This property specifies the relative flow angle at the impeller leading edge. Note that this is not available when the InletOption is set to 'Calculated'.

Type     Quantity
Read Only    No
Beta3

This property reports the meanline section relative flow angle at the impeller exit station.

Type     Quantity
Read Only    Yes
Beta3hub

This property reports the hub section relative flow angle at the impeller exit station.

Type     Quantity
Read Only    Yes
Beta3shroud

This property reports the shroud section relative flow angle at the impeller exit station.

Type     Quantity
Read Only    Yes
Beta3User

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

Type     Quantity
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 VistaRTD popup GUI.

Available options:

mm
cm
inches
ft
m

Type    BMunitsType
Read Only    No
ClearanceOption

This property specifies impeller tip clearance is specified. 'Ratio' indicates that the tip clearance is specified as a fraction of the tip width 'User' specifies that the clearance will be defined directly by the user.

Available options:

Ratio
User

Type    ClearanceType
Read Only    No
ClearLoss

This property reports the proportion of energy loss attributed to the clearances between rotating and stationary components. Note this is only available when using the 'Correlation' for the efficiency calculation method, EtaOpt.

Type     float
Read Only    Yes
ClearRatioUser

This property specifies the ratio of the impeller tip clearance to the tip width. Note that this is only available when ClearanceOption is set to 'Ratio'.

Type     float
Read Only    No
ClearUser

This property specifies the value of the impeller tip clearance. Note that this is only available when ClearanceOption is set to 'User'.

Type     Quantity
Read Only    No
CorrelationOption

This property specifies the correlation used to calculate the stage efficiency. Note that this is only available when the EtaOption is set to 'Correlation'.

Available options:

Suhrmann
Baines

Type    EtaCorrelType
Read Only    No
CpMean

This property reports the average specific heat capacity at constant pressure for the turbine stage.

Type     Quantity
Read Only    Yes
CpUser

This property specifies the specific heat capacity at constant pressure, Cp, of the working fluid. This is only available when using the Fixed option for GasProps.

Type     Quantity
Read Only    No
D2

This property reports the impeller inlet diameter.

Type     Quantity
Read Only    Yes
D3hub

This property reports the impeller exit hub diameter.

Type     Quantity
Read Only    Yes
D3shroud

This property reports the impeller exit shroud diameter.

Type     Quantity
Read Only    Yes
DiameterRatio

This property reports the ratio of the impeller inlet diameter to the meanline exit diameter.

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
EtaImpTS

This property reports the total-to-static impeller efficiency.

Type     float
Read Only    Yes
EtaImpTT

This property reports the total-to-total impeller efficiency.

Type     float
Read Only    Yes
EtaNozzle

This property specifies the value of the total-to-static nozzle efficiency. The term 'nozzle' here refers to the geometry upstream of the impeller used to control the inlet flow angle. This may be either bladed or unbladed, eg. a volute. A specified nozzle efficiency of 1.0 implies no pressure loss across the nozzle and consequently the nozzle is neglected from the calculation.

Type     float
Read Only    No
EtaOption

This property specifies whether to use a correlation to automatically calculate the turbine stage efficiency, or to use a user-defined efficiency.

Available options:

User
Correlation

    template1 = GetTemplate(TemplateName="VistaRTD")
    system1 = template1.CreateSystem()
    bladeDesign1 = system1.GetContainer(ComponentName="Blade Design")
    vistaRTDProperties1 = bladeDesign1.GetVistaRTDBladeDesignProperties()
    vistaRTDProperties1.EtaOption = "Correlation"

Type    EtaType
Read Only    No
EtaStageTS

This property reports the total-to-static stage efficiency.

Type     float
Read Only    Yes
EtaStageTT

This property reports the total-to-total stage efficiency.

Type     float
Read Only    Yes
EtaUser

This property specifies the value of the total-to-total turbine stage efficiency. Note that this entry is only available when the EtaOption is set to 'User'.

Type     float
Read Only    No
ExitAngle

This property specifies the flow angle at the impeller exit. This will either be an absolute or relative value depending on the 'ExitOption'.

Type     Quantity
Read Only    No
ExitLoss

This property reports the proportion of energy loss attributed to the exhaust. Note this is only available when using the 'Correlation' for the efficiency calculation method, EtaOpt.

Type     float
Read Only    Yes
ExitOption

This property specifies the ExitAngle type.

Available options:

Absolute
Relative

Type    ExitAngleType
Read Only    No
ExpRatio

This property specifies the design point total-to-total expansion ratio, P01/P03, for the turbine stage.

Type     float
Read Only    No
ExpRatioTs

This property reports the total to static expansion ratio for the turbine stage (P01/P3).

Type     float
Read Only    Yes
FricLoss

This property reports the proportion of energy loss attributed to friction. Note this is only available when using the 'Correlation' for the efficiency calculation method, EtaOpt.

Type     float
Read Only    Yes
GammaMean

This property reports the average ratio of specific heats (gamma) for the turbine stage.

Type     float
Read Only    Yes
GasProps

This property specifies the method used to calculate the properties of the working fluid.

Available options:

Air
AFR
Fixed

    template1 = GetTemplate(TemplateName="VistaRTD")
    system1 = template1.CreateSystem()
    bladeDesign1 = system1.GetContainer(ComponentName="Blade Design")
    vistaRTDProperties1 = bladeDesign1.GetVistaRTDBladeDesignProperties()
    vistaRTDProperties1.GasProps = "AFR"

Type    GasPropType
Read Only    No
HubRatio

This property specifies the ratio of the impeller exit radius at the hub to the impeller inlet radius (tip radius). This enables the hub exit radius to be controlled in a non-dimensional way.

Type     float
Read Only    No
ImpellerLength

This property reports the ratio of the impeller axial length to the impeller tip diameter.

Type     float
Read Only    Yes
ImpellerLengthOption

This property specifies whether the impeller length ratio is calculated automatically, or specified by the user.

Available options:

Automatic
User

Type    ImpellerLengthType
Read Only    No
ImpellerLengthUser

This property specifies the ratio of the impeller axial length to the impeller tip diameter. This enables the impeller axial length to be controlled in a non-dimensional way.

Type     float
Read Only    No
ImpellerLengthUserOpt

This property specifies whether the impeller axial length ratio will be defined by the user.

Type     bool
Read Only    No
ImpellerNumber

This property specifies the number of impeller vanes.

Type     int
Read Only    No
ImpellerThickness

This property specifies the average vane thickesses at the impeller exit.

Type     Quantity
Read Only    No
IncLoss

This property reports the proportion of energy loss attributed to the incidence at the leading edge. Note this is only available when using the 'Correlation' for the efficiency calculation method, EtaOpt.

Type     float
Read Only    Yes
InletAngle

OBSOLETE PROPERTY RETAINED FOR BACKWARDS COMPATIBILITY IN THE POST MIGRATION STEP

This property specifies the flow angle at the impeller inlet. This will either be specified as an absolute or relative value depending on the 'InletOption'.

Type    Quantity
Read Only    No
InletOption

This property specifies the InletAngle type.

Available options:

Absolute
Relative
Calculated. ****** OBSOLETE OPTION PLEASE USE ABSOLUTE OR RELATIVE ********

Type    InletAngleType
Read Only    No
Loading

This property reports the basic loading for the turbine stage (delH/U^2).

Type     float
Read Only    Yes
LoadLoss

This property reports the proportion of energy loss attributed to loading. Note this is only available when using the 'Correlation' for the efficiency calculation method, EtaOpt.

Type     float
Read Only    Yes
Mach2

This property reports the absolute Mach number at the impeller inlet.

Type     float
Read Only    Yes
Mach3rms

This property reports the meanline section absolute Mach number at the impeller exit station.

Type     float
Read Only    Yes
MachRel2

This property reports the relative Mach number at the impeller inlet.

Type     float
Read Only    Yes
MachRel3shroud

This property reports the shroud section relative Mach number at the impeller exit station.

Type     float
Read Only    Yes
MassFlow

This property specifies the design point mass flow rate passing through the turbine stage.

Type     Quantity
Read Only    No
MrootToverP

This property reports the characteristic flow function for the design point (M x SQRT(T) / P).

Type     float
Read Only    Yes
NozChkRatio

This property reports the choke ratio for the nozzle.

Type     float
Read Only    Yes
NozExitDiameter

This property reports the nozzle exit diameter.

Type     Quantity
Read Only    Yes
NozThtArea

This property reports the throat area of the nozzle.

Type     Quantity
Read Only    Yes
NozVlessRatio

This property reports the ratio of the 'vaneless' nozzle area to the impeller inlet radius. Note that the nozzle area used here neglects the vane thickness, hence the 'vaneless' prefix.

Type     Quantity
Read Only    Yes
Ns

This property reports the specific speed of the impeller.

Type     float
Read Only    Yes
Omega

This property specifies the design point rotational speed of the impeller.

Type     Quantity
Read Only    No
OvrChkRatio

This property reports the overall choke ratio (mass flow/choke flow) for the turbine stage.

Type     float
Read Only    Yes
P02

This property reports the total pressure at impeller inlet.

Type     Quantity
Read Only    Yes
P03

This property reports the total pressure at impeller exit.

Type     Quantity
Read Only    Yes
P2

This property reports the static pressure at impeller inlet.

Type     Quantity
Read Only    Yes
P3

This property reports the static pressure at impeller exit.

Type     Quantity
Read Only    Yes
Power

This property reports the aerodynamic power generated by the turbine, neglecting mechanical losses.

Type     Quantity
Read Only    Yes
Reaction

This property reports the degree of reaction for the turbine stage, (T2 - T3)/(T01 - T03).

Type     float
Read Only    Yes
RelVelRatShroud

This property reports the ratio of the impeller exit relative velocity at the shroud (W3shr) to the impeller inlet relative velocity (W2).

Type     float
Read Only    Yes
RUser

This property specifies the specific gas constant, R, of the working fluid. This is only available when using the Fixed option for GasProps.

Type     Quantity
Read Only    No
ShroudRatio

This property specifies the ratio of the impeller exit radius at the shroud to the impeller inlet radius (tip radius). This enables the shroud exit radius to be controlled in a non-dimensional way.

Type     float
Read Only    No
SpanwiseDistributionOption

This property specifies the spanwise distribution used when exporting the impeller blade.

Available options:

General
Radial

Type    SpanwiseDistributionType
Read Only    No
SpeedRatio

This property specifies the blade speed ratio, U2/C0, of the impeller, where U2 is the impeller tip speed and C0 is the spouting velocity. In this definition the spouting velocity is calculated from the total-to-total isentropic temperature drop.

Type     float
Read Only    No
StagPressure

This property specifies the design point stagnation pressure, P01, at the inlet to the turbine stage. Note that this is defined upstream of the nozzle guide vane ahead of the impeller.

Type     Quantity
Read Only    No
StagTemp

This property specifies the design point stagnation temperature, T01, at the inlet to the turbine stage. Note that this is defined upstream of the nozzle guide vane ahead of the impeller.

Type     Quantity
Read Only    No
SurfaceFinish

This property specifies the surface finish of the impeller. The surface roughness has a secondary effect on the calculated efficiency.

Available options:

Machined
Cast

Type    RoughnessType
Read Only    No
T02

This property reports the total temperature at impeller inlet.

Type     Quantity
Read Only    Yes
T03

This property reports the total temperature at impeller exit.

Type     Quantity
Read Only    Yes
T2

This property reports the static temperature at impeller inlet.

Type     Quantity
Read Only    Yes
T3

This property reports the static temperature at impeller exit.

Type     Quantity
Read Only    Yes
TipWidth

This property reports the impeller inlet tip width.

Type     Quantity
Read Only    Yes
TotalLoss

This property reports the sum of the friction, loading, clearance and exit losses. It is equal to one minus the total-to-total stage efficiency. Note this is only available when using the 'Correlation' for the efficiency calculation method, EtaOpt.

Total losses

Type    float
Read Only    Yes
U2

This property reports the blade speed at the impeller inlet (tip speed)

Type     Quantity
Read Only    Yes
U3shroud

This property reports the shroud section blade speed (tip speed) at the impeller exit station.

Type     Quantity
Read Only    Yes
V2

This property reports the absolute velocity at the impeller inlet.

Type     Quantity
Read Only    Yes
V3rms

This property reports the meanline section absolute velocity at the impeller exit station.

Type     Quantity
Read Only    Yes
Vax3rms

This property reports the meanline section axial velocity at the impeller exit station.

Type     Quantity
Read Only    Yes
VelRatio1

This property reports the flow coefficient at impeller exit. This is the ratio of the average axial velocity at the impeller exit (Vax3) to the impeller tip speed (U2).

Type     float
Read Only    Yes
VelRatio2

This property reports the blade speed ratio, U2/C0, of the impeller, where U2 is the impeller tip speed and C0 is the spouting velocity. In this definition the spouting velocity is calculated from the total-to-static isentropic temperature drop.

Type     float
Read Only    Yes
Vr2

This property reports the radial velocity at the impeller inlet.

Type     Quantity
Read Only    Yes
Vw2

This property reports the swirl (tangential) velocity at the impeller inlet

Type     Quantity
Read Only    Yes
Vw3rms

This property reports the meanline section swirl velocity at the impeller exit station.

Type     Quantity
Read Only    Yes
W2

This property reports the relative velocity at the impeller inlet.

Type     Quantity
Read Only    Yes
W3shroud

This property reports the shroud section relative velocity at the impeller exit station.

Type     Quantity
Read Only    Yes
ZeroBetaInlet

Specifies whether or not the relative flow angle at the impeller inlet is zero. Note that a zero inlet angle is a 'special case' where the exit angles are calculated rather than specified.

Type     bool
Read Only    No