Skip to main content

Line integral convolution for numpy arrays

Project description

PyPI PyPI - License PyPI - Python Version Gitlab pipeline status Coverage Documentation Status

⎣⫯ℂ: Line Integral Convolution for numpy Arrays

This package provides line integral convolution (lic) algorithms to Python.

lic image of the Kelvin-Helmholtz instability

lic image of the Kelvin-Helmholtz instability

There are functions which can be imported and are highly configurable for the power user. Moreover, there is a command line tool to generate lic images without having to code a single line.


The installation is straight forward. You can install the package via pip, pipenv, poetry and alike or by downloading the source from the gitlab repository.


To get the latest features or contribute to the development, you can clone the whole project using git:

git clone

Now you can, for instance, copy over to your project and import it directly or use it as a command line tool.


You can import lic in your program and use the functions directly or use the command line tool.

Importing the module

Once the package is installed where Python can find it, you can use the function lic directly.

import lic
import matplotlib.pyplot as plt

# ... get x and y arrays from somewhere ...

lic_result = lic.lic(x, y, length=30)

plt.imshow(lic_result, origin='lower', cmap='gray')

Find out more about the options by reading the source documentation:

pydoc lic.lic

You can also control the seed, i.e., the underlying texture for the lic:

pydoc lic.gen_seed

You can run the example from the root folder to see the result:

PYTHONPATH="." python3 examples/

Command Line Tool

You will need npy data files (saved using to use lic from the command line:

lic data_x.npy data_y.npy -v -l 30 -c

See lic --help for a full list of options.

How to Contribute

If you find a bug, want to propose a feature or need help getting this package to work with your data on your system, please don’t hesitate to file an issue or write an email. Merge requests are also much appreciated!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lic-0.4.5.tar.gz (205.9 kB view hashes)

Uploaded Source

Built Distribution

lic-0.4.5-py3-none-any.whl (251.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page