CModel.SetConfidenceLevel: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:cModel.SetConfindenceLevel}}
{{DISPLAYTITLE:cModel.SetConfidenceLevel}}{{Template:API}}{{Template:APIBreadcrumb|.[[CModel Class|cModel]]}}
{{Template:APIClass|CModel Class|CModel}}  
Sets confidence level for bounds calculations.
== Method Syntax==
{{APIName|SetConfindenceLevel}}
{{APIName|(}}
{{APIPrefix|ByVal}}
{{APIName|Level}}
{{APIPrefix|As Double}}
{{APIName|,}}
{{APIPrefix|ByVal}}
{{APIName|Sides}}
{{APIPrefix|As}}
{{APIName|[[ConfBoundsSides]],}}
{{APIPrefix|ByVal}}
{{APIName|UseConfidenceLevelInPercents}}
{{APIPrefix|As Boolean,}}
{{APIPrefix|ByRef}}
{{APIName|sError}}
{{APIPrefix|As String}}
{{APIName|)}}
{{APIPrefix|As Boolean}}<br>
{{APIComment|Sets the confidence level for all subsequent confidence bounds calculations.}}


== Parameters ==
'''Level'''
{{APIComment|The confidence level.}}


'''Sides'''
<onlyinclude>Sets the confidence level to use in confidence bounds calculations for published models. Returns a '''Boolean''' value; when true, indicates that a confidence level has been set.</onlyinclude>
{{APIComment|The sides setting for this confidence level.}}


'''UseConfidenceLevelInPercents'''
== Syntax ==
{{APIComment|Show result in percentages or decimal.}}
'''.SetConfidenceLevel'''(''Level'', ''Sides'', ''UseConfidenceLevelInPercents'', {{APIPrefix|ByRef}} ''sError'')


'''sError'''
===Parameters===
{{APIComment|Return string for any error results.}}
''Level''
:Required. Double. The confidence level, entered as a percentage.


== Usage Example ==
''Sides''
{{APIComment|Declare the cModel class using an in-line parameter list.}}
:Required. The sides setting (e.g., lower bound) for this confidence level. Can be any [[ConfBoundsSides Enumeration|ConfBoundsSides]] constant.
        Dim newModel As New cModel(ModelTypeEnum.Weibull2, ModelCategoryEnum.Reliability, "NewModel1", 1, 100)


{{APIComment|Set a new confidence level. Set SetsError for any errors found during this method}}
''UseConfidenceLevelInPercents''
        Dim SuccessSetConfLevel As Boolean
:Required. Boolean. When true, the result is shown as a percentage; otherwise, it is shown as a decimal.
        Dim SetsError As String
 
        SuccessSetConfLevel = newModel.SetConfindenceLevel(.9, [[ConfBoundsSides]].TwoSidedBoth, False, SetsError)
''sError''
:Required. String. Returns a string for any error results.
 
 
== Example ==
This example assumes that a published model with ID #47 exists in the repository.
 
'''VBA'''
{{APIComment|...}}
{{APIComment|'Get model ID #47 from project ID #1 in the repository.}}
  {{APIPrefix|Dim}} AModel {{APIPrefix|As}} cModel
  MyRepository.Project.SetCurrentProject(1) 
  {{APIPrefix|Set}} AModel = MyRepository.Model.GetModel(47)
{{APIComment|'Set the confidence level to 90% two-sided bounds.}}
{{APIComment|'Declare a string variable for any errors found during this method.}}
  {{APIPrefix|Dim}} ErrorMsg {{APIPrefix|As}} String
  {{APIPrefix|Call}} AModel.SetConfidenceLevel(0.9, ConfBoundsSides_TwoSidedBoth, False, ErrorMsg)
{{APIComment|'Confidence bounds calculations are now possible. For example,}}
{{APIComment|'the following code calculates the 90% two-sided confidence bounds on the reliability at 100 hrs.}}
  {{APIPrefix|Dim}} ResultValue {{APIPrefix|As}} BoundsValues
  {{APIPrefix|Set}} ResultValue = AModel.Bounds_Reliability(100)
 
'''VB.NET'''
{{APIComment|...}}
{{APIComment|'Get model ID #47 from project ID #1 in the repository.}}
  {{APIPrefix|Dim}} AModel {{APIPrefix|As}} cModel
  MyRepository.Project.SetCurrentProject(1) 
  AModel = MyRepository.Model.GetModel(47)
{{APIComment|'Set the confidence level to 90% two-sided bounds.}}
{{APIComment|'Declare a string variable for any errors found during this method.}}
  {{APIPrefix|Dim}} ErrorMsg {{APIPrefix|As}} String
  AModel.SetConfidenceLevel(0.9, ConfBoundsSides.TwoSidedBoth, False, ErrorMsg)
{{APIComment|'Confidence bounds calculations are now possible. For example,}}
{{APIComment|'the following code calculates the 90% two-sided confidence bounds on the reliability at 100 hrs.}}
  {{APIPrefix|Dim}} ResultValue {{APIPrefix|As}} BoundsValues
  ResultValue = AModel.Bounds_Reliability(100)

Latest revision as of 19:02, 9 June 2016

APIWiki.png


Member of: SynthesisAPI.cModel


Sets the confidence level to use in confidence bounds calculations for published models. Returns a Boolean value; when true, indicates that a confidence level has been set.

Syntax

.SetConfidenceLevel(Level, Sides, UseConfidenceLevelInPercents, ByRef sError)

Parameters

Level

Required. Double. The confidence level, entered as a percentage.

Sides

Required. The sides setting (e.g., lower bound) for this confidence level. Can be any ConfBoundsSides constant.

UseConfidenceLevelInPercents

Required. Boolean. When true, the result is shown as a percentage; otherwise, it is shown as a decimal.

sError

Required. String. Returns a string for any error results.


Example

This example assumes that a published model with ID #47 exists in the repository.

VBA

 ... 

 'Get model ID #47 from project ID #1 in the repository. 
  Dim AModel As cModel
  MyRepository.Project.SetCurrentProject(1)  
  Set AModel = MyRepository.Model.GetModel(47)

 'Set the confidence level to 90% two-sided bounds. 
 'Declare a string variable for any errors found during this method. 
  Dim ErrorMsg As String
  Call AModel.SetConfidenceLevel(0.9, ConfBoundsSides_TwoSidedBoth, False, ErrorMsg)

 'Confidence bounds calculations are now possible. For example, 
 'the following code calculates the 90% two-sided confidence bounds on the reliability at 100 hrs. 
  Dim ResultValue As BoundsValues
  Set ResultValue = AModel.Bounds_Reliability(100)
VB.NET

 ... 

 'Get model ID #47 from project ID #1 in the repository. 
  Dim AModel As cModel
  MyRepository.Project.SetCurrentProject(1)  
  AModel = MyRepository.Model.GetModel(47)

 'Set the confidence level to 90% two-sided bounds. 
 'Declare a string variable for any errors found during this method. 
  Dim ErrorMsg As String
  AModel.SetConfidenceLevel(0.9, ConfBoundsSides.TwoSidedBoth, False, ErrorMsg)

 'Confidence bounds calculations are now possible. For example, 
 'the following code calculates the 90% two-sided confidence bounds on the reliability at 100 hrs. 
  Dim ResultValue As BoundsValues
  ResultValue = AModel.Bounds_Reliability(100)