BlockDiscreteStaticSystem.java

/**
 * $Id$
 *
 * Copyright (C) 2004-2005 Koga Laboratory. All rights reserved.
 */

package org.mklab.tool.control.system.discrete;

import java.util.List;

import org.mklab.nfc.matrix.ComplexNumericalMatrix;
import org.mklab.nfc.matrix.RealNumericalMatrix;
import org.mklab.nfc.ode.SolverStopException;
import org.mklab.nfc.scalar.ComplexNumericalScalar;
import org.mklab.nfc.scalar.RealNumericalScalar;
import org.mklab.tool.control.system.SystemOperator;


/**
 * 差分方程式で表現されるブロック離散時間静的システムを表すクラスです。
 * 
 * @author koga
 * @version $Revision$
  * @param <RS> type of real scalar
 * @param <RM> type of real matrix
 * @param <CS> type of complex scalar
 * @param <CM> type of complex matrix
*/
public class BlockDiscreteStaticSystem<RS extends RealNumericalScalar<RS,RM,CS,CM>, RM extends RealNumericalMatrix<RS,RM,CS,CM>, CS extends ComplexNumericalScalar<RS,RM,CS,CM>, CM extends ComplexNumericalMatrix<RS,RM,CS,CM>> extends BlockDiscreteSystem<RS,RM,CS,CM> implements DiscreteStaticSystem<RS,RM,CS,CM> {

  /**
   * 新しく生成された<code>BlockDiscreteStaticSystem</code>オブジェクトを初期化します。
   * 
   * @param elements 隣接行列
   * @param inputNodes 入力ノード番号のリスト(番号は1から始まる)
   * @param outputNodes 出力ノード番号のリスト(番号は1から始まる)
   * @param sunit unit of scalar
   */
  public BlockDiscreteStaticSystem(final SystemOperator<RS,RM,CS,CM>[][] elements, final List<Integer> inputNodes, final List<Integer> outputNodes, RS sunit) {
    super(elements, inputNodes, outputNodes, sunit);
    setDynamic(false);
  }

  /**
   * {@inheritDoc}
   */
  public RM outputEquation(final int k, final RM u) throws SolverStopException {
    resetNodeValue();
    setInputNodeValue(u);
    calcNodeValue(k);
    return getOutputNodeValue();
  }

  /**
   * {@inheritDoc}
   */
  public RM outputEquation(final RS t, final RM u) throws SolverStopException {
    resetNodeValue();
    setInputNodeValue(u);
    calcNodeValue(t);
    return getOutputNodeValue();
  }

  /**
   * @see org.mklab.tool.control.system.discrete.DiscreteStaticSystem#outputEquation(int)
   */
  public RM outputEquation(final int k) throws SolverStopException {
    resetNodeValue();
    setInputNodeValue(this.sunit.createZeroGrid(getInputSize(), 1));
    calcNodeValue(k);
    return getOutputNodeValue();
  }

  /**
   * {@inheritDoc}
   */
  public RM outputEquation(final RS t) throws SolverStopException {
    resetNodeValue();
    setInputNodeValue(this.sunit.createZeroGrid(getInputSize(), 1));
    calcNodeValue(t);
    return getOutputNodeValue();
  }

  /**
   * {@inheritDoc}
   */
  public RM inputOutputEquation(final int k) throws SolverStopException {
    final RM u = this.sunit.createZeroGrid(getInputSize(), 1);
    final RM y = outputEquation(k);
    return u.appendDown(y);
  }

  /**
   * {@inheritDoc}
   */
  public RM inputOutputEquation(final RS t) throws SolverStopException {
    final RM u = this.sunit.createZeroGrid(getInputSize(), 1);
    final RM y = outputEquation(t);
    return u.appendDown(y);
  }
}