Public API

Contents

Index

Public interface

To utilize the public interface, first import the required packages:

julia> using GershgorinDiscs

Types

GershgorinDiscs.GershgorinDiscType
GershgorinDisc{T}

Represent a Gershgorin disc in the complex plane associated with a matrix.

Arguments

  • center: a tuple (real_part, imaginary_part) representing the center of the disc.
  • radius: a non-negative real number representing the radius of the disc.
source

Functions

Base.inMethod
in(number, disc::GershgorinDisc)

Check if a number is within the Gershgorin disc.

source
Base.inMethod
in(a::GershgorinDisc, b::GershgorinDisc)

Check if one Gershgorin disc is within another Gershgorin disc.

source
Base.isapproxMethod
isapprox(a::GershgorinDisc, b::GershgorinDisc; kwargs...)

Check if two GershgorinDisc objects are approximately equal.

source
GershgorinDiscs.eigvals_extremaMethod
eigvals_extrema(A::AbstractMatrix)

Estimate the minimum and maximum eigenvalues of a square matrix A using Gershgorin circle theorem.

This function computes the Gershgorin discs for A and returns the smallest and largest values that any eigenvalue could have based on the discs.

source
GershgorinDiscs.list_discsMethod
list_discs(A::AbstractMatrix)

Compute the Gershgorin discs for a square matrix.

Each disc has its center at a diagonal element, and its radius is the smaller value between the row and column sums for that element.

Arguments

  • A::AbstractMatrix: a square matrix (either real or complex).

Examples

julia> A = [4.0 1.0; 0.5 3.0]
2×2 Matrix{Float64}:
 4.0  1.0
 0.5  3.0

julia> list_discs(A)
2-element Vector{GershgorinDisc{Float64}}:
 GershgorinDisc{Float64}((4.0, 0.0), 0.5)
 GershgorinDisc{Float64}((3.0, 0.0), 0.5)
source