https://github.com/hsma-tools/lokigi
[WIP - alpha] A Python library for location optimization, focussing on solving methods that can output a range of solutions rather than just the 'best' option
https://github.com/hsma-tools/lokigi
facility-location facility-location-problem location-allocation location-optimization maximal-covering-location-problem p-center p-median python
Last synced: 4 days ago
JSON representation
[WIP - alpha] A Python library for location optimization, focussing on solving methods that can output a range of solutions rather than just the 'best' option
- Host: GitHub
- URL: https://github.com/hsma-tools/lokigi
- Owner: hsma-tools
- License: mit
- Created: 2026-04-02T11:01:05.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-06-11T18:06:10.000Z (9 days ago)
- Last Synced: 2026-06-11T19:19:45.048Z (8 days ago)
- Topics: facility-location, facility-location-problem, location-allocation, location-optimization, maximal-covering-location-problem, p-center, p-median, python
- Language: Python
- Homepage: https://hsma-tools.github.io/lokigi/lokigi_docs/
- Size: 791 MB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 64
-
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
## lokigi - Generate, rank, analyse and visualise the best candidate solutions for facility location problems
| | |
| --- | --- |
| **Project info:** |  [](https://orcid.org/0000-0002-9552-8988) [](#contributors) |
| **Installation:** | [](https://pypi.org/project/lokigi/) |
| **Metrics:** | [](https://pepy.tech/project/lokigi) [](https://pepy.tech/project/lokigi) [](https://pepy.tech/project/lokigi)  |
| **Activity:** |    [](https://GitHub.com/hsma-tools/lokigi/pulls?q=is%3Aopen) |
| **Build & quality status:** | [](https://www.repostatus.org/#active) [](https://github.com/hsma-tools/lokigi/actions/workflows/tests.yml) [](https://github.com/hsma-tools/lokigi/actions/workflows/docker_quarto.yml) |
| **Supported platforms:** |   |
---
lokigi means 'to locate' or 'to place' in the Esperanto language.
(or it's the backronym '**L**ocation **O**ptimisation: **K**-best solution **I**nspection, **G**eneration & **I**nsights' - whichever floats your boat)
lokigi exists to make the process of providing decision support for healthcare problems with a geographical component easier.
A range of fantastic libraries exist for geographic optimization (e.g. [spopt](https://pysal.org/spopt/)), but many use linear programming to optimize the solution, meaning you emerge with a single optimal solution. For healthcare contexts, this often isn't ideal - decision makers need a range of near-optimal solutions to balance against real-world constraints.
Building on [work from Dr Tom Monks](https://github.com/health-data-science-OR/healthcare-logistics/tree/master/optimisation) and [previous rounds of the Health Service Modelling Associates programme](https://hsma.co.uk/hsma_content/modules/current_module_details/3_geographic_modelling_visualisation.html), lokigi is designed to make it easier to beginner programmers to tackle location optimization problems for the benefit of their organisations.
Lokigi is planned to expand to boundary optimisation problems in the future.
# Getting started
Head to the [documentation](https://hsma-tools.github.io/lokigi/lokigi_docs/) to find out how to use the package.
Install the package with `pip install lokigi`
> [!WARNING]
> Lokigi is currently in an alpha state and not advised to be used for production. However, we would welcome feedback as we move towards a full release.
Conda support coming very soon.
## Contributors
Sammi Rosser
💻 📖 ⚠️ 🐛 🖋 🎨 💡 🤔 🚇 🚧 📆 🔬 ✅
Tom Monks
💻 🤔 🧑🏫
Dr Daniel Chalk
🧑🏫
Amy Heather
🚇 📖
## Note
This package builds on work from the metapy project from Dr Tom Monks.
Metapy can be found [here](https://github.com/health-data-science-OR/healthcare-logistics/tree/master/optimisation/metapy).
Metapy is release under the MIT licence. The licence is reproduced below in line with the terms of the licence.
> MIT License
> Copyright (c) 2020 health-data-science-OR
> Permission is hereby granted, free of charge, to any person obtaining a copy
> of this software and associated documentation files (the "Software"), to deal
> in the Software without restriction, including without limitation the rights
> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
> copies of the Software, and to permit persons to whom the Software is
> furnished to do so, subject to the following conditions:
> The above copyright notice and this permission notice shall be included in all
> copies or substantial portions of the Software.
> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
> SOFTWARE.
Modified metapy code is noted within the source code.