Metadata-Version: 2.3
Name: bfact-core
Version: 0.1.2
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 Boolean matrix factorisation.

### Install & run

Install as `pip install bfact-core`, which should create CLI command `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).
     

