bud_gain()
Returns budget transducer-power gain
Syntax
y = bud_gain(vIn, iIn, Zs, Plan, pinNumber, "simName") or y = bud_gain("SourceName", SrcIndx, Zs, Plan, budgetPath)
Arguments
| Name | Description | Range | Type | Default | Required |
|---|---|---|---|---|---|
| vIn | voltage flowing into the input port | (-∞, ∞) | complex | yes | |
| iIn | current flowing into the input port | (-∞, ∞) | complex | yes | |
| SourceName | component name at the input port | string | yes | ||
| SrcIndx † | frequency index that corresponds to the source frequency to determine which frequency to use from a multitone source as the reference signal | [1, ∞) | integer | 1 | no |
| Zs | input source port impedance | [0, ∞) | real | 50.0 | no |
| Plan † | number of the selected frequency plan(needed only for HB) | string | no | ||
| pinNumber | Used to choose which pins of each network element are referenced ‡ | [1, ∞) | integer | 1 | no |
| budgetPath | Selects the budget path, specified as an array eg. PORT1.t1,Tee1.t3,Term3.t1 | string array | no | ||
| simName | simulation instance name, such as "AC1" or "HB1", used to qualify the data when multiple simulations are performed. | string | no | ||
| † Note that for AC simulation, both the SrcIndx and Plan arguments must not be specified; these are for HB only. ‡ If 1 is passed as the pinNumber, the results at pin 1 of each element are returned; otherwise, the results for all pins of each element are returned. By default, the pinNumber is set to 1. | |||||
Examples
x = bud_gain(PORT1.t1.v, PORT1.t1.i) or
x = bud_gain("PORT1")
y= bud_gain(PORT1.t1.v, PORT1.t1.i, 75) or
y= bud_gain("PORT1", , 75., 1)
z = bud_gain(PORT1.t1.v[3], PORT1.t1.i[3], , 1) or
z= bud_gain("PORT1", 3, , 1)
Defined in
$HPEESOF_DIR/expressions/ael/budget_fun.ael
See Also
Notes/Equations
Used in AC and harmonic balance simulations
This is the power gain (in dB) from the input port to the terminal(s) of each component, looking into that component. Power gain is defined as power delivered to the resistive load minus the power available from the source. Note that the fundamental frequency at different pins can be different. If vIn and iIn are passed directly, one may want to use the index of the frequency sweep explicitly to reference the input source frequency.
 | Note Remember that the budget function can refer only to the default dataset, that is, the dataset selected in the data display window. |
Budget Path Measurements
Instead of all components in alphabetical order, this function can report its values just for the components selected in a budget path, and following the sequence in that path. To facilitate the budget path measurements, the name of the budget path variable (as defined in the Schematic window), must be entered as the budgetPath argument. Use the alternate syntax for budget path measurements as shown below.
bud_gain("SourceName", SrcIndx, Zs, Plan, budgetPath)
Privacy
Statement 
|
Terms of Use |
Legal |
Contact Us |
© Agilent 2000-2008
