# Eigenvalue visualizer

- Human page: https://happytails.ai/en/calculators/eigenvalue-visualizer/
- Markdown: https://happytails.ai/en/calculators/eigenvalue-visualizer.md
- Structured JSON: https://happytails.ai/agents/en/calculators/eigenvalue-visualizer/index.json
- Visibility: public

## Tool capabilities

| Property | Value |
| --- | --- |
| Tool ID | `eigenvalue-visualizer` |
| Category | calculators |
| Implementation | Registered implementation. Registration alone is not a production-quality guarantee. |
| Browser execution | Use the visible action or interactive controls. |
| Browser processing | Browser; see tool notes for network behavior. |
| HTTP API | Not callable through HTTP. |
| Browser-agent interface | run_current_tool |

### Implementation notes

Finds the characteristic polynomial and supported exact eigenpairs on your device for square matrices up to 8 by 8. Higher-degree complex roots are numerical approximations.

### Inputs and settings

Text input: Matrix.

Example or placeholder shown in the interface (not a validated fixture):

```text
4 1
2 3
```

One row per line or separated by semicolons; entries such as 3, -0.5 or 2/3. Up to 20,000 characters. Review the settings before running.

No additional settings are declared for this tool.

### Browser-agent workflow

1. Open the human page in a browser that supports WebMCP.
2. Discover the interface exposed by that page; use its actual schema.
3. Select files on the page first when the tool requires files.
4. Call `run_current_tool` with valid input and settings.
5. Inspect the returned result or error and the displayed output. Retrieve files from the displayed download links.

Calls do not automatically copy or download results. Browser permissions still apply. Interface availability alone is not proof of successful execution.

### Planning specification

Square matrices from 1 by 1 to 8 by 8, up to 20,000 characters, with exact entries of at most 100 digits; factoring uses factors up to degree 24. Everything is computed on your device in a background worker with a 15 second limit. Downloads are a JSON report, a CSV of eigenvalues and an SVG plot.

This describes intended requirements. Use the implementation notes, interface schema and observed output to determine current support.

### Complete machine-readable capability record

```json
{
  "id": "eigenvalue-visualizer",
  "category": "calculators",
  "built": true,
  "requirements": "Square matrices from 1 by 1 to 8 by 8, up to 20,000 characters, with exact entries of at most 100 digits; factoring uses factors up to degree 24. Everything is computed on your device in a background worker with a 15 second limit. Downloads are a JSON report, a CSV of eigenvalues and an SVG plot.",
  "implementation": {
    "fields": [],
    "presentation": "metrics",
    "inputCodeDirection": "ltr",
    "registrationFamily": "exact-math-discrete",
    "inputMaxLength": 20000,
    "inputErrorCode": "EXACT_MATH_DISCRETE_MATRIX_TOO_LONG",
    "note": "Finds the characteristic polynomial and supported exact eigenpairs on your device for square matrices up to 8 by 8. Higher-degree complex roots are numerical approximations.",
    "experience": {
      "automatic": false,
      "single": false,
      "inputMaxLength": 20000,
      "inputMode": "text",
      "label": "Matrix",
      "placeholder": "4 1\n2 3",
      "help": "One row per line or separated by semicolons; entries such as 3, -0.5 or 2/3. Up to 20,000 characters. Review the settings before running.",
      "helpParts": [
        "One row per line or separated by semicolons; entries such as 3, -0.5 or 2/3.",
        "Up to 20,000 characters.",
        "Review the settings before running."
      ],
      "action": null
    },
    "mode": "explicit",
    "interactive": false
  },
  "execution": "Browser interface",
  "api": null,
  "browser_agent": {
    "supported": true,
    "name": "run_current_tool",
    "discovery": "WebMCP on the human page in a supporting browser",
    "verification": "See audit/API-AUDIT.md; availability is not verification"
  }
}
```

## Page guide

Find the exact characteristic polynomial of a square matrix of fractions. Rational and real quadratic eigenvalues include exact eigenvectors; higher-degree real roots are isolated exactly, and higher-degree complex roots are numerical approximations.

### How to use Eigenvalue visualizer

1. Paste a square matrix, one row per line, such as 4 1 and 2 3.
2. Run the visualizer to compute the characteristic polynomial and factor it.
3. Read the eigenvalue kinds, multiplicities, supported eigenvectors and diagonalizability status. A null status means the method did not determine it.
4. Download the JSON report, the CSV of eigenvalues or the plot.

How can we improve this tool?

Report a problem or share an idea.

Please leave out private information. Your message and the tool name go to our team via PostHog.

## Useful next steps

- [Matrix workspace](https://happytails.ai/en/calculators/matrix-workspace/) ([Markdown](https://happytails.ai/en/calculators/matrix-workspace.md))

- [Linear system solver](https://happytails.ai/en/calculators/linear-system-solver/) ([Markdown](https://happytails.ai/en/calculators/linear-system-solver.md))

- [Graphing calculator](https://happytails.ai/en/calculators/graphing-calculator/) ([Markdown](https://happytails.ai/en/calculators/graphing-calculator.md))

Square matrices from 1 by 1 to 8 by 8, up to 20,000 characters, with exact entries of at most 100 digits; factoring uses factors up to degree 24. Everything is computed on your device in a background worker with a 15 second limit. Downloads are a JSON report, a CSV of eigenvalues and an SVG plot.

## Exact method

The characteristic polynomial det(tI - A) is computed with the Faddeev-LeVerrier recurrence in exact fractions and checked against the determinant. It is factored over the rationals. Rational and real quadratic roots give exact eigenvectors from the null space of A - tI, verified by multiplication. Eigenvectors for other root kinds are not computed. Method: Strang, Introduction to Linear Algebra, 5th edition, chapter 6 (2016); Faddeev and Faddeeva, Computational Methods of Linear Algebra (1963).

### Higher-degree factors

Real roots of irreducible cubic or higher factors are isolated exactly with Sturm sequences and shown with a decimal value. Complex roots of those factors are numerical approximations with polynomial residuals. A small residual checks a candidate root; it does not prove that every complex root was found or that a complete eigenbasis was computed.

### Plot

For a 2 by 2 matrix with real eigenvalues the plot shows the unit circle, its image and the invariant directions. Otherwise it shows the eigenvalues in the complex plane.
