https://github.com/letiziaia/multiway-alignment

A python library providing measures of multiway issue alignment.
https://github.com/letiziaia/multiway-alignment

alignment computational-social-science data-science polarization python

Last synced: 11 months ago
JSON representation

A python library providing measures of multiway issue alignment.

• Host: GitHub
• URL: https://github.com/letiziaia/multiway-alignment
• Owner: letiziaia
• License: apache-2.0
• Created: 2023-01-31T17:34:48.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-09-23T07:06:12.000Z (almost 2 years ago)
• Last Synced: 2024-10-29T13:55:53.836Z (over 1 year ago)
• Topics: alignment, computational-social-science, data-science, polarization, python
• Language: Python
• Homepage:
• Size: 588 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![multiway-alignment](https://github.com/letiziaia/multiway-alignment/actions/workflows/validate.yml/badge.svg)](https://github.com/letiziaia/multiway-alignment/actions/workflows/validate.yml)

[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/release/python-3100/)

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://github.com/letiziaia/multiway-alignment/blob/main/LICENSE)

[![codecov](https://codecov.io/gh/letiziaia/multiway-alignment/graph/badge.svg?token=KSXP8K5A8S)](https://codecov.io/gh/letiziaia/multiway-alignment)

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.12593833.svg)](https://doi.org/10.5281/zenodo.12593833)

[![arXiv](https://img.shields.io/badge/arXiv-2408.00139-b31b1b.svg)](https://arxiv.org/abs/2408.00139)

# multiway-alignment

This repository implements an algorithm for quantifying multiway alignment or higher-order alignment, that is, the alignment across n different issues or dimensions. You can refer to the [paper](https://arxiv.org/abs/2408.00139) for more details.

## Structure of the repo

- `\multiway_alignment\`: source code

- `\tests\`: tests for the source code

## Installing the package

### From PIP

This package can be installed directly from the Python Package Index (PyPI) using `pip` from the command-line interface by executing the following command:

```shell

$ pip install multiway-alignment

```

### Build from source

Alternatively, the package can be installed by first cloning the repository containing the source code and then installing the package locally in a chosen directory:

```shell

$ git clone git@github.com:letiziaia/multiway-alignment.git

$ cd multiway-alignment

$ pip install .

```

## Setting up the development environment

![python](https://img.shields.io/badge/Python-FFD43B?style=for-the-badge&logo=python&logoColor=blue)

You should have python >= 3.10 and [pipenv](https://github.com/pypa/pipenv#installation) installed.

```shell

# install dependencies (including dev)

$ pipenv install --dev

# activate environment

$ pipenv shell

```

## Formatting

The project uses [Black](https://black.readthedocs.io/en/stable/index.html), [flake8](https://flake8.pycqa.org/en/latest/) and [ruff](https://docs.astral.sh/ruff/) code linting.

All the code can be formatted by running `python3 -m black .` in root dir.

Additional issues can be found by running `python3 -m flake8 .` and `python3 -m ruff check .` in root dir.

## Tests

This code is built and tested for python 3.10, 3.11, 3.12, and 3.13.