Definitions.h

Go to the documentation of this file.

/* Copyright 2017-2021 Institute for Automation of Complex Power Systems,
 *                     EONERC, RWTH Aachen University
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
 *********************************************************************************/
 
#pragma once
 
#include <cerrno>
#include <cmath>
#include <complex>
#include <exception>
#include <memory>
#include <string>
#include <system_error>
 
#ifdef __clang__
#elif defined(__GNUC__)
#pragma GCC diagnostic push
#if __GNUC__ >= 7
#pragma GCC diagnostic ignored                                                 \
    "-Wint-in-bool-context" // https://eigen.tuxfamily.org/bz/show_bug.cgi?id=1402
#endif
#endif
 
#include <Eigen/Dense>
#include <Eigen/Sparse>
 
#ifdef __clang__
#elif defined(__GNUC__)
#pragma GCC diagnostic pop
#endif
 
// VS2017 doesn't define M_PI unless _USE_MATH_DEFINES is included before cmath
// which is hard to guarantee, so we make sure it is defined here
#define DPS_PI PI
#ifndef PI
#ifndef M_PI
#define M_PI 3.14159265358979323846
#endif
#define PI M_PI
#endif
 
#define SHIFT_TO_PHASE_B Complex(cos(-2 * M_PI / 3), sin(-2 * M_PI / 3))
#define SHIFT_TO_PHASE_C Complex(cos(2 * M_PI / 3), sin(2 * M_PI / 3))
#define RMS_TO_PEAK sqrt(2.)
#define PEAK_TO_RMS sqrt(1 / 2.)
#define RMS3PH_TO_PEAK1PH sqrt(2. / 3.)
#define PEAK1PH_TO_RMS3PH sqrt(3. / 2.)
 
#define P_SNUB_TRANSFORMER 1e-3 // 0.1% of rated power
#define Q_SNUB_TRANSFORMER 5e-4 // 0.05% of rated power
#define DOUBLE_EPSILON 1E-12
 
namespace CPS {
 
// ### Types ###
typedef unsigned int UInt;
typedef int Int;
typedef double Real;
typedef std::complex<Real> Complex;
typedef bool Bool;
typedef std::string String;

typedef Eigen::Matrix<Complex, Eigen::Dynamic, 1> VectorComp;
typedef Eigen::Matrix<Real, Eigen::Dynamic, 1> Vector;
typedef Eigen::SparseMatrix<Real, Eigen::ColMajor> SparseMatrix;
typedef Eigen::SparseMatrix<Real, Eigen::RowMajor> SparseMatrixRow;
typedef Eigen::SparseMatrix<Complex, Eigen::ColMajor> SparseMatrixComp;
typedef Eigen::SparseMatrix<Complex, Eigen::RowMajor> SparseMatrixCompRow;
typedef Eigen::Matrix<Real, Eigen::Dynamic, Eigen::Dynamic, Eigen::ColMajor>
    Matrix;
typedef Eigen::Matrix<Complex, Eigen::Dynamic, Eigen::Dynamic, Eigen::ColMajor>
    MatrixComp;
typedef Eigen::Matrix<Int, Eigen::Dynamic, Eigen::Dynamic, Eigen::ColMajor>
    MatrixInt;
typedef Eigen::Matrix<Real, Eigen::Dynamic, Eigen::Dynamic, Eigen::RowMajor>
    MatrixRow;
typedef Eigen::PartialPivLU<Matrix> LUFactorized;
typedef Eigen::SparseLU<SparseMatrix> LUFactorizedSparse;
template <typename VarType>
using MatrixVar =
    Eigen::Matrix<VarType, Eigen::Dynamic, Eigen::Dynamic, Eigen::ColMajor>;
template <int rows, int cols>
using MatrixFixedSize = Eigen::Matrix<Real, rows, cols, Eigen::ColMajor>;
template <int rows, int cols>
using MatrixFixedSizeComp = Eigen::Matrix<Complex, rows, cols, Eigen::ColMajor>;
 
// ### Constants ###
static const Complex jComp(0.0, 1.0);
 
// ### Enumerations ###
enum class NumericalMethod { Euler, Trapezoidal };
enum class PhaseType { A, B, C, ABC, Single };
enum class Domain { SP, DP, EMT };
enum class PowerflowBusType { PV, PQ, VD, None };
enum class GeneratorType {
  PVNode,
  IdealVoltageSource,
  IdealCurrentSource,
  TransientStability,
  FullOrder,
  FullOrderVBR,
  SG6aOrderVBR,
  SG6bOrderVBR,
  SG5OrderVBR,
  SG4OrderVBR,
  SG3OrderVBR,
  SG4OrderPCM,
  SG4OrderTPM,
  SG6OrderPCM,
  None
};
enum class SGOrder { SG3Order, SG4Order, SG5Order, SG6aOrder, SG6bOrder };
 
enum class CouplingMethod { DELAY, EXTRAPOLATION_ZOH, EXTRAPOLATION_LINEAR };
 
// ### Exceptions ###
class Exception : public std::exception {};
class AccessException : public Exception {};
class TypeException : public Exception {};
class InvalidAttributeException : public Exception {};
class InvalidArgumentException : public Exception {};
 
class SystemError {
protected:
  std::error_code mErrorCode;
  String mDescription;
 
public:
  SystemError(const String &desc, int e)
      : mErrorCode(e, std::system_category()), mDescription(desc){};
 
  SystemError(const String &desc)
      : mErrorCode(errno, std::system_category()), mDescription(desc){};
 
  SystemError() : mErrorCode(errno, std::system_category()){};
 
  String descr() const {
    std::ostringstream os;
 
    os << "System Error: " << mDescription << ": " << mErrorCode.message()
       << "(" << mErrorCode.value() << ")";
 
    return os.str();
  };
};
} // namespace CPS