Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/harshangrjn/laplacianopt.jl
A Julia/JuMP Package for Maximizing Algebraic Connectivity of Undirected Weighted Graphs
https://github.com/harshangrjn/laplacianopt.jl
algebraic-connectivity discrete-optimization fiedler-vector graph-algorithms laplacian-matrix mixed-integer-optimization optimization robust-networks semidefinite-programming
Last synced: about 1 month ago
JSON representation
A Julia/JuMP Package for Maximizing Algebraic Connectivity of Undirected Weighted Graphs
- Host: GitHub
- URL: https://github.com/harshangrjn/laplacianopt.jl
- Owner: harshangrjn
- License: mit
- Created: 2021-04-28T15:39:43.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-09-14T04:06:35.000Z (4 months ago)
- Last Synced: 2024-10-13T22:34:29.414Z (3 months ago)
- Topics: algebraic-connectivity, discrete-optimization, fiedler-vector, graph-algorithms, laplacian-matrix, mixed-integer-optimization, optimization, robust-networks, semidefinite-programming
- Language: Julia
- Homepage:
- Size: 5.31 MB
- Stars: 25
- Watchers: 6
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Citation: CITATION.bib
Awesome Lists containing this project
README
A Julia Package for Maximizing Algebraic Connectivity of Graphs
Status:
[](https://github.com/harshangrjn/LaplacianOpt.jl/actions/workflows/ci.yml)
[](https://codecov.io/gh/harshangrjn/LaplacianOpt.jl)
[](https://harshangrjn.github.io/LaplacianOpt.jl/dev/)
[](https://juliahub.com/ui/Packages/LaplacianOpt/V1JEg/)
## LaplacianOpt
**LaplacianOpt** is a Julia package which implements polyhedral relaxation-based algorithms for the maximimum algebraic connectivity augmentation problem on weighted graph Laplacians. More specifically, given a weighted base graph with existing edges (could be empty), a set of candidate weighted edges for augmentation, and an augmentation budget (`K`), this package finds a set of `K` edges to augment to the base graph such that the resulting graph has maximum algebraic conenctivity with optimality guarantees. For example, given a base graph with `N` vertices and `0` edges, set of candidate edges which form a complete graph, and `K = (N-1)`, this packages finds a spanning tree with maximum algebraic connectivity.
[Algebraic connectivity](https://dml.cz/bitstream/handle/10338.dmlcz/101168/CzechMathJ_23-1973-2_11.pdf) is the second smallest eigenvalue of the graph Laplacian. The magnitude of this value reflects how well connected the overall graph is. This connectivity measure has been used in analyzing the robustness and synchronizability of complex networks, and in graph sparsification techniques.
## Usage
- Clone the repository.
- Open a terminal in the repo folder and run `julia --project=.`.
- Hit `]` to open the project environment and run `test` to run unit tests. If
you see an error because of missing packages, run `resolve`.
Check the "examples" folder on how to use this package.
## Bug reports and support
Please report any issues via the Github **[issue tracker](https://github.com/harshangrjn/LaplacianOpt.jl/issues)**. All types of issues are welcome and encouraged; this includes bug reports, documentation typos, feature requests, etc.
## Acknowledgement
This work was supported by Los Alamos National Laboratory (LANL)'s LDRD Early Career Research Award (20190590ECR) and [LANL-TAMU's collaborative research project](https://nationallabsoffice.tamus.edu/the-texas-am-university-system-and-los-alamos-national-laboratory-partner-to-design-robust-networks/) grant. The primary developer of this package is [Harsha Nagarajan](http://harshanagarajan.com) ([@harshangrjn](https://github.com/harshangrjn)).
## Citing LaplacianOpt
If you find LaplacianOpt.jl useful in your work, we request you to cite the following papers [\[link-1\]](https://doi.org/10.1109/ECC.2015.7330770) [\[link-2\]](https://doi.org/10.1109/TCNS.2024.3431408):
```bibtex
@article{LOpt_TCNS2024,
title={Optimal robust network design: Formulations and algorithms for maximizing algebraic connectivity},
author={Somisetty, Neelkamal and Nagarajan, Harsha and Darbha, Swaroop},
journal={IEEE Transactions on Control of Network Systems},
url = {https://doi.org/10.1109/TCNS.2024.3431408},
year={2024},
publisher={IEEE}
}
@inproceedings{LOpt_ECC2015,
title={On maximizing algebraic connectivity of networks for various engineering applications},
author={Nagarajan, Harsha and Rathinam, Sivakumar and Darbha, Swaroop},
booktitle={European Control Conference (ECC)},
pages={1626--1632},
year={2015},
organization={IEEE}
}
```