Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Lanczos Eigenvector #11906

Merged
merged 1 commit into from
Dec 30, 2024
Merged

Conversation

jeffreyyancey
Copy link
Contributor

@jeffreyyancey jeffreyyancey commented Oct 8, 2024

Fixes: #12386

Title: Add Lanczos Eigenvector Algorithm for Graph-based Eigenvalue Computation

Description:

This pull request introduces a new algorithm for approximating the largest eigenvalues and eigenvectors of a symmetric matrix in the context of graphs, using the Lanczos method. The implementation leverages adjacency list representation to handle sparse graphs effectively and includes the following:

Commit:

Initial Commit: Add Lanczos Eigenvector Algorithm for Graph-based Eigenvalue Computation

  • Implemented find_lanczos_eigenvectors for efficient computation of k-largest eigenvalues and eigenvectors in sparse graphs.
  • Developed lanczos_iteration for constructing tridiagonal matrices.
  • Added multiply_matrix_vector for efficient adjacency-list matrix-vector multiplication.
  • Ensured code meets PEP 8 standards and passed ruff linting.
  • Included a comprehensive module-level docstring, explaining the algorithm, complexity, and example usage for context.
  • Add an algorithm?
  • Fix a bug or typo in an existing algorithm?
  • Add or change doctests? -- Note: Please avoid changing both code and tests in a single pull request.
  • Documentation change?

Checklist:

  • I have read CONTRIBUTING.md.
  • This pull request is all my own work -- I have not plagiarized.
  • I know that pull requests will not be merged if they fail the automated tests.
  • This PR only changes one algorithm file. To ease review, please open separate PRs for separate algorithms.
  • All new Python files are placed inside an existing directory.
  • All filenames are in all lowercase characters with no spaces or dashes.
  • All functions and variable names follow Python naming conventions.
  • All function parameters and return values are annotated with Python type hints.
  • All functions have doctests that pass the automated testing.
  • All new algorithms include at least one URL that points to Wikipedia or another similar explanation.
  • If this pull request resolves one or more open issues then the description above includes the issue number(s) with a closing keyword: "Fixes #ISSUE-NUMBER".

…eigenvalues and corresponding eigenvectors of a graph based on its adjacency list.

- Utilized `lanczos_iteration` to construct tridiagonal matrices, optimized for large, sparse matrices.
- Added `multiply_matrix_vector` for efficient matrix-vector multiplication using adjacency lists.
- Included `validate_adjacency_list` for input validation.

- Supports varied graph analysis applications, particularly for analyzing graph centrality.
- Included type hints, comprehensive docstrings, and doctests.
- PEP-8 compliant, with optimized handling of inputs and outputs.

This module provides essential tools for eigenvalue-based graph analysis, ideal for centrality insights and structural assessments.
Copy link
Contributor

@imSanko imSanko left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks Fine wait for [at] clauss

@cclauss cclauss merged commit 7e55fb6 into TheAlgorithms:master Dec 30, 2024
5 checks passed
@isidroas isidroas mentioned this pull request Jan 25, 2025
14 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants