Skip to main content

No project description provided

Project description


GitHub PyPI GitHub commit activity GitHub last commit Downloads DOI Lines of code

fuzzy-c-means is a Python module implementing the Fuzzy C-means clustering algorithm.


the fuzzy-c-means package is available in PyPI. to install, simply type the following command:

pip install fuzzy-c-means

command line interface

You can read the file for more information about this tool.

basic clustering example

simple example of use the fuzzy-c-means to cluster a dataset in two groups:

importing libraries

%matplotlib inline
import numpy as np
from fcmeans import FCM
from matplotlib import pyplot as plt

creating artificial data set

n_samples = 3000

X = np.concatenate((
    np.random.normal((-2, -2), size=(n_samples, 2)),
    np.random.normal((2, 2), size=(n_samples, 2))

fitting the fuzzy-c-means

fcm = FCM(n_clusters=2)

showing results

# outputs
fcm_centers = fcm.centers
fcm_labels = fcm.predict(X)

# plot result
f, axes = plt.subplots(1, 2, figsize=(11,5))
axes[0].scatter(X[:,0], X[:,1], alpha=.1)
axes[1].scatter(X[:,0], X[:,1], c=fcm_labels, alpha=.1)
axes[1].scatter(fcm_centers[:,0], fcm_centers[:,1], marker="+", s=500, c='w')

to more examples, see the examples/ folder.

how to cite fuzzy-c-means package

if you use fuzzy-c-means package in your paper, please cite it in your publication.

  author       = {Madson Luiz Dantas Dias},
  title        = {fuzzy-c-means: An implementation of Fuzzy $C$-means clustering algorithm.},
  month        = may,
  year         = 2019,
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.3066222},
  url          = {}


contributing and support

this project is open for contributions. here are some of the ways for you to contribute:

  • bug reports/fix
  • features requests
  • use-case demonstrations

please open an issue with enough information for us to reproduce your problem. A minimal, reproducible example would be very helpful.

to make a contribution, just fork this repository, push the changes in your fork, open up an issue, and make a pull request!


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

fuzzy-c-means-1.6.4.tar.gz (8.7 kB view hashes)

Uploaded source

Built Distribution

fuzzy_c_means-1.6.4-py3-none-any.whl (9.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page