Switch

Switch between the first and the third inputs output based on the value of the second input.

Collaboration diagram for Switch:

The second input (In2) is compared to zero. In1 is sent to the output if the test is true, and In3 is sent to the output if the test is false. The test is made per element.

SwitchType	Out is In1 if	Otherwise Out is In3
"gt" or ">"	In2 > 0	In2 <= 0
"lt" or "<"	In2 <= 0	In2 > 0
"eq" or "=="	In2 == 0	In2 != 0
"ne" or "!="	In2 != 0	In2 == 0

Note that "lt" includes zero: it is the exact complement of "gt". At In2 == 0 both "lt" and "eq" pass In1.

Author

Benjamin Scholz

Date

06.09.2007 BSC: Initial version.

20.07.2011 KGA: Ported to FhSim 2.0.

25.07.2011 KGA: Added documentation.

Example configuration excerpt

<Lib
  LibName    = "fhsim_base"
  SimObject  = "Signal/Switch"
  Name       = "Gt"
  SwitchType = "gt"
/>
 
<Connection
  Gt.In1="1"
  Gt.In2="Pulse.Out" <!-- from somewhere -->
  Gt.In3="3"
/>

Input Ports

Name	Width	Description
In1	<PortWidth>	The first input signal
In2	<PortWidth>	The control signal
In3	<PortWidth>	The second input signal

Output Ports

Name	Width	Description
Out	<PortWidth>	The selected input signal

Configuration parameters

Name	Width	Description
PortWidth	1	The number of elements in the input and output ports.
SwitchType	-	The logic type used in the comparison supported types*: "<" ">" "!=" or "==". Also accepts "gt", "lt", "eq", and "ne".

Initial conditions

There are no initial conditions for this function.

Full example file

<Contents>
  <OBJECTS>
    <Lib
        LibName="base" 
        SimObject="Signal/Switch"  
        Name="Gt" 
        SwitchType="gt"
    />
    <Lib
        LibName="base" 
        SimObject="Signal/Switch"  
        Name="Lt" 
        SwitchType="lt"
    />
    <Lib
        LibName="base" 
        SimObject="Signal/Switch"  
        Name="Eq" 
        SwitchType="eq"
    />
    <Lib
        LibName="base" 
        SimObject="Signal/Switch"  
        Name="Ne" 
        SwitchType="ne"
    />
    <Lib
        LibName="base" 
        SimObject="Src/Pulse"  
        Name="Pulse" 
        Amplitude="1"
        Period="1"
        Width="0.5"
        Delay="0"
        Bias="0"
    />
  </OBJECTS>
  
  <INTERCONNECTIONS>
    <Connection
        Gt.In1="1"
        Gt.In2="Pulse.Out"
        Gt.In3="3"
        Lt.In1="1"
        Lt.In2="Pulse.Out"
        Lt.In3="3"
        Eq.In1="1"
        Eq.In2="Pulse.Out"
        Eq.In3="3"
        Ne.In1="1"
        Ne.In2="Pulse.Out"
        Ne.In3="3"
    />
  </INTERCONNECTIONS>
  
  <INITIALIZATION>
    <InitialCondition
    />
  </INITIALIZATION>
  
  <SIMULATION>
    <Timing TStart="0" TEnd="3.0"/>
    <Integrator Method="RK45_i" NumCores="1" LogStates="1" UseRSSNorm="0">
      <StepControl StepMax="0.002" StepMin="0.00000001" AbsTol="1e-3" RelTol="1e-3"/>
    </Integrator>
    
  </SIMULATION>
 
<OBSERVERS>
    <FileOutput TOutput="0, 0:0.5:2, 30" Select="objects:all"/>
  </OBSERVERS>
</Contents>

This SimObject is referred to as Signal/Switch