URI-ABD: Clustered Learning of Approximate Manifolds
Installation
Docker
docker build -t clam .
Python
python3 -m pip install pyclam
Usage
Docker
docker run clam --help
Python Scripting
from pyclam import Manifold
from pyclam import CAKES
from pyclam import criterion
from pyclam.utils import synthetic_datasets
# Get the data.
data, _ = synthetic_datasets.bullseye()
# data is a numpy.ndarray in this case but it could just as easily be a numpy.memmap if your data does fit in RAM.
# We used numpy memmaps for the research, though they impose file-IO costs.
search = CAKES(data, 'euclidean')
# The Search class provides the functionality described in our CHESS paper.
# TODO: Provide link to CHESS paper
search.build(max_depth=10)
# Build the search tree to depth of 10.
# This method can be called again with a higher depth, if needed.
query, radius = data[0], 0.5
rnn_results = search.rnn(query, radius)
# This is how we perform rho-nearest neighbors search with radius 0.5 around the query.
knn_results = search.knn(query, 10)
# This is how to perform k-nearest neighbors search for the 10 nearest neighbors of query.
# TODO: Provide snippets for using CHAODA
# You can also directly use the Manifold functionality provided by CLAM.
manifold = Manifold(data, 'euclidean')
# Any metric allowed by scipy's cdist function is allowed in Manifold.
# You can also define your own distance function. It will work so long as scipy allows it.
manifold.build(
criterion.MaxDepth(20), # build the tree to a maximum depth of 20
criterion.MinRadius(0.25), # clusters with radius less than 0.25 cannot be partitioned.
criterion.Layer(6), # use the clusters ad depth 6 to build a Graph.
criterion.Leaves(), # use the leaves of the tree to build another Graph.
)
# Manifold.build can optionally take any number of criteria.
# pyclam.criterion defines some criteria that we have used in research.
# You are free to define your own.
# Take a look at pyclam/criterion.py for hints of how to define custom criteria.
The Manifold class relies on the Graph and Cluster classes. You can import these and work with them directly if you so choose. The classes and methods are all very well documented. Go crazy.
Contributing
Pull requests and bug reports are welcome. For major changes, please open an issue to discuss what you would like to change.
License
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pyclam-0.6.6.tar.gz
(36.5 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
pyclam-0.6.6-py3-none-any.whl
(40.3 kB
view details)
File details
Details for the file pyclam-0.6.6.tar.gz.
File metadata
- Download URL: pyclam-0.6.6.tar.gz
- Upload date:
- Size: 36.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/4.0.0 CPython/3.9.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8ebef62ac9929611bcf437a2922e7fae950d15ac978b7c44b5a5d52b88031281
|
|
| MD5 |
6384bea98e97ec12e69216ef23038554
|
|
| BLAKE2b-256 |
cacd97e6c4821b77b7912ad589a0a1124d16317304e612f44df128a14f42a8f8
|
File details
Details for the file pyclam-0.6.6-py3-none-any.whl.
File metadata
- Download URL: pyclam-0.6.6-py3-none-any.whl
- Upload date:
- Size: 40.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/4.0.0 CPython/3.9.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9c37c6893648d7138c1b743afa23ceb739b7934ea9e2c45e73a7f7549ce991af
|
|
| MD5 |
0053d04b0b38bff3a37c29ce94b7fc4c
|
|
| BLAKE2b-256 |
3cec5f53568f0b8c04ead85bf1c034a77b985302f23cc442fdcabbd8e55f60c8
|
