This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

setterminals

Set terminals of circuit object

Syntax

setterminals(cktobj,cktnodes)
setterminals(cktobj,cktnodes,termnames)

Description

example

setterminals(cktobj,cktnodes) defines the nodes in a cktobj as terminals using cktnodes. It then gives the terminals default names.

example

setterminals(cktobj,cktnodes,termnames) defines the nodes in a cktobj as terminals cktnodes. It then names the terminals using termnames. cktnodes and termnames must be same length.

Examples

collapse all

Create a circuit names new_circuit1.

hckt1 = circuit('new_circuit1');

Add a resistor and capacitor to the circuit.

add(hckt1,[1 2],resistor(50));
add(hckt1,[2 3],capacitor(1e-9));

Set the terminals of the circuit.

setterminals(hckt1,[1 3])
disp(hckt1)
  circuit: Circuit element

    ElementNames: {'R'  'C'}
        Elements: [1x2 rf.internal.circuit.RLC]
           Nodes: [1 2 3]
            Name: 'new_circuit1'
       Terminals: {'t1'  't2'}

Create a circuit and add three resistors to it.

hckt2 = circuit('example_circuit2');
add(hckt2,[1 2],resistor(50));
add(hckt2,[1 3],resistor(50));
add(hckt2,[1 4],resistor(50));

Set terminals of the circuit by using (a, b, c) as termnames.

setterminals(hckt2,[2 3 4],{'a' 'b' 'c'})
disp(hckt2)
  circuit: Circuit element

    ElementNames: {'R'  'R_1'  'R_2'}
        Elements: [1x3 resistor]
           Nodes: [1 2 3 4]
            Name: 'example_circuit2'
       Terminals: {'a'  'b'  'c'}

Create circuit 1 and set the terminals using the setterminals functions.

hckt1 = circuit('circuit_new1');
add(hckt1,[1 2], resistor(100));
setterminals(hckt1, [1 2]);
disp(hckt1);
  circuit: Circuit element

    ElementNames: {'R'}
        Elements: [1x1 resistor]
           Nodes: [1 2]
            Name: 'circuit_new1'
       Terminals: {'t1'  't2'}

Create circuit 2 and set the terminals.

hckt2 = circuit('circuit_new2');
add(hckt2, [3 4], capacitor(1.5e-9));
setterminals(hckt2, [3 4]);
disp(hckt2);
  circuit: Circuit element

    ElementNames: {'C'}
        Elements: [1x1 capacitor]
           Nodes: [3 4]
            Name: 'circuit_new2'
       Terminals: {'t1'  't2'}

Add the two circuits.

add(hckt1, [2 4], hckt2);
disp(hckt2)
  circuit: Circuit element

    ElementNames: {'C'}
        Elements: [1x1 capacitor]
           Nodes: [3 4]
            Name: 'circuit_new2'
       Terminals: {'t1'  't2'}
     ParentNodes: [2 4]
      ParentPath: 'circuit_new1'
disp(hckt1)
  circuit: Circuit element

    ElementNames: {'R'  'circuit_new2'}
        Elements: [1x2 rf.internal.circuit.Element]
           Nodes: [1 2 4]
            Name: 'circuit_new1'
       Terminals: {'t1'  't2'}

Input Arguments

collapse all

Circuit object for which the terminals are defined, specified as a scalar handle object.

Circuit nodes, used by the function to define the terminals of the circuit, specified as a vector of integers.

Names, used to identify the terminals defined for the circuit object, specified as a character vector.

Introduced in R2013b