Metadata-Version: 2.3
Name: bfact-core
Version: 0.1.0
Summary: 
License: MIT
Author: evissch
Requires-Python: >=3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: anndata (>=0.11.4,<0.12.0)
Requires-Dist: click (>=8.2.0,<9.0.0)
Requires-Dist: gurobipy (>=12.0.2,<13.0.0)
Requires-Dist: igraph (>=0.11.8,<0.12.0)
Requires-Dist: leidenalg (>=0.10.2,<0.11.0)
Requires-Dist: numba (>=0.61.2,<0.62.0)
Requires-Dist: numpy (>=2.2.5,<3.0.0)
Requires-Dist: pandas (>=2.2.3,<3.0.0)
Requires-Dist: scanpy (>=1.11.1,<2.0.0)
Requires-Dist: scikit-learn (>=1.1,<2.0)
Requires-Dist: scipy (>=1.15.3,<2.0.0)
Description-Content-Type: text/markdown

## BFACT

This is python package for performing binary matrix factorisation.

### Install & run

Install as: `pip install .`

Soon will be registered on PyPI and can use `pip install bfact`

You can then get available options by running `bfact --help`.

### Expected inputs: 

--in-file: path to .h5ad or a tab separated file containing binary matric

--out-stub: The path + prefix for ouputs.

Any other input, see `bfact --help` for available options.

### Expected ouptuts: 

`{out_stub}_best_{metric}.L.txt`

`{out_stub}_best_{metric}.R.txt`

`{out_stub}_best_{metric}.summary_info.json`

`{out_stub}_{num_considered_factors}_cols.pkl` (only if --to-save-cols specified true). This file stores the candidate factors used in the restricted master problem. It is useful for large matrices to save time if provided in future runs (using the base as --saved-cols-stub).
     

