Documentation

This is machine translation

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

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan 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'}
           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'}
           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'}
           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'}
           Nodes: [3 4]
            Name: 'circuit_new2'
       Terminals: {'t1'  't2'}

Add the two circuits.

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

    ElementNames: {'C'}
           Nodes: [3 4]
            Name: 'circuit_new2'
       Terminals: {'t1'  't2'}
     ParentNodes: [2 4]
      ParentPath: 'circuit_new1'

  circuit: Circuit element

    ElementNames: {'R'  'circuit_new2'}
           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

Was this topic helpful?