https://github.com/cthoyt/geometric-graphs

Generate knowledge graphs with interesting geometries, like lattices
https://github.com/cthoyt/geometric-graphs

Last synced: about 1 month ago
JSON representation

Generate knowledge graphs with interesting geometries, like lattices

• Host: GitHub
• URL: https://github.com/cthoyt/geometric-graphs
• Owner: cthoyt
• License: mit
• Created: 2021-11-06T15:52:59.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2023-08-12T10:59:57.000Z (over 1 year ago)
• Last Synced: 2024-09-14T08:04:57.108Z (2 months ago)
• Language: Python
• Size: 45.9 KB
• Stars: 5
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE

Awesome Lists containing this project

README

        




  Geometric Graphs





    

        

    

    

         

    

    

        

    

    

        

    

    

        

    

    

        

    

    

        

    



Generate knowledge graphs with interesting geometries, like lattices.

Works on Python 3.9+ because it uses cool new features. Get out of that 2020

funk and install the most recent version of Python.

## 💪 Getting Started

See https://github.com/cthoyt/translational-toys for example usage to generate

charts like 

![](https://github.com/cthoyt/translational-toys/raw/main/results/line/embedding.gif).

## 🚀 Installation

The most recent release can be installed from

[PyPI](https://pypi.org/project/geometric_graphs/) with:

```bash

$ pip install geometric_graphs

```

The most recent code and data can be installed directly from GitHub with:

```bash

$ pip install git+https://github.com/cthoyt/geometric-graphs.git

```

To install in development mode, use the following:

```bash

$ git clone git+https://github.com/cthoyt/geometric-graphs.git

$ cd geometric-graphs

$ pip install -e .

```

## 👐 Contributing

Contributions, whether filing an issue, making a pull request, or forking, are appreciated. See

[CONTRIBUTING.rst](https://github.com/cthoyt/geometric-graphs/blob/master/CONTRIBUTING.rst) for more information on getting involved.

## 👋 Attribution

### ⚖️ License

The code in this package is licensed under the MIT License.

### 🍪 Cookiecutter

This package was created with [@audreyfeldroy](https://github.com/audreyfeldroy)'s

[cookiecutter](https://github.com/cookiecutter/cookiecutter) package using [@cthoyt](https://github.com/cthoyt)'s

[cookiecutter-snekpack](https://github.com/cthoyt/cookiecutter-snekpack) template.

## 🛠️ For Developers

  See developer instrutions

  

The final section of the README is for if you want to get involved by making a code contribution.

### ❓ Testing

After cloning the repository and installing `tox` with `pip install tox`, the unit tests in the `tests/` folder can be

run reproducibly with:

```shell

$ tox

```

Additionally, these tests are automatically re-run with each commit in a [GitHub Action](https://github.com/cthoyt/geometric-graphs/actions?query=workflow%3ATests).

### 📦 Making a Release

After installing the package in development mode and installing

`tox` with `pip install tox`, the commands for making a new release are contained within the `finish` environment

in `tox.ini`. Run the following from the shell:

```shell

$ tox -e finish

```

This script does the following:

1. Uses BumpVersion to switch the version number in the `setup.cfg` and

   `src/geometric_graphs/version.py` to not have the `-dev` suffix

2. Packages the code in both a tar archive and a wheel

3. Uploads to PyPI using `twine`. Be sure to have a `.pypirc` file configured to avoid the need for manual input at this

   step

4. Push to GitHub. You'll need to make a release going with the commit where the version was bumped.

5. Bump the version to the next patch. If you made big changes and want to bump the version by minor, you can

   use `tox -e bumpversion minor` after.