Skip to content

Commit

Permalink
chore: Doc upgrades
Browse files Browse the repository at this point in the history
  • Loading branch information
mwiewior committed Jan 10, 2025
1 parent 95f2d21 commit 46e4c66
Show file tree
Hide file tree
Showing 5 changed files with 14 additions and 3 deletions.
7 changes: 4 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,12 @@
It provides a DataFrame API for genomics data and is designed to be blazing fast, memory efficient and easy to use.

## Key Features
* optimized for [peformance](docs/performance.md#results-summary-) and large-scale genomics datasets
* popular genomics [operations](docs/features.md#genomic-ranges-operations) with a DataFrame API (both [Pandas](https://pandas.pydata.org/) and [polars](https://pola.rs/))
* optimized for [peformance](https://biodatageeks.org/polars-bio/performance/) and large-scale genomics datasets
* popular genomics [operations](https://biodatageeks.org/polars-bio/features/#genomic-ranges-operations) with a DataFrame API (both [Pandas](https://pandas.pydata.org/) and [polars](https://pola.rs/))
* native parallel engine powered by Apache DataFusion and [sequila-native](https://github.com/biodatageeks/sequila-native)
* [out-of-core](docs/features.md#streaming-out-of-core-processing-exeprimental) processing (for data too large to fit into a computer's main memory) with [Apache DataFusion](https://datafusion.apache.org/) and [polars](https://pola.rs/)
* [out-of-core](https://biodatageeks.org/polars-bio/features#streaming-out-of-core-processing-exeprimental) processing (for data too large to fit into a computer's main memory) with [Apache DataFusion](https://datafusion.apache.org/) and [polars](https://pola.rs/)
* zero-copy data exchange with [Apache Arrow](https://arrow.apache.org/)
* bioinformatics file [formats](https://biodatageeks.org/polars-bio/features.md#file-formats-support) with [exon](https://github.com/wheretrue/exon)
* pre-built wheel packages for *Linux*, *Windows* and *MacOS* (*arm64* and *x86_64*) available on [PyPI](https://pypi.org/project/polars-bio/#files)


Expand Down
1 change: 1 addition & 0 deletions docs/cookbook.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,3 +12,4 @@

[//]: # (## How to set logging level)

[//]: # (## How to read from object storage)
6 changes: 6 additions & 0 deletions docs/features.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,12 @@ polars-bio supports out-of-core processing with Polars LazyFrame [streaming](htt
| expand | :white_check_mark: | :construction: | :white_check_mark: | :white_check_mark: | | :white_check_mark: |
| sort | :white_check_mark: | :construction: | :white_check_mark: | :white_check_mark: | | :white_check_mark: |


## File formats support




## API comparison between libraries
There is no standard API for genomic ranges operations in Python.
This table compares the API of the libraries. The table is not exhaustive and only shows the most common operations used in benchmarking.
Expand Down
1 change: 1 addition & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ It is designed to be easy to use, fast and memory efficient with a focus on geno
* native parallel engine powered by Apache DataFusion and [sequila-native](https://github.com/biodatageeks/sequila-native)
* [out-of-core](features.md#streaming-out-of-core-processing) processing (for data too large to fit into a computer's main memory) with [Apache DataFusion](https://datafusion.apache.org/) and [polars](https://pola.rs/)
* zero-copy data exchange with [Apache Arrow](https://arrow.apache.org/)
* bioinformatics file [formats](features.md#file-formats-support) with [exon](https://github.com/wheretrue/exon)
* pre-built wheel packages for *Linux*, *Windows* and *MacOS* (*arm64* and *x86_64*) available on [PyPI](https://pypi.org/project/polars-bio/#files)

[//]: # (* support for common genomics file formats (VCF, BAM and FASTQ))
2 changes: 2 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,13 +11,15 @@ nav:
- 📚 Tutorial: notebooks/tutorial.ipynb
- 🚀 Performance: performance.md
- ⚙️ API reference: api.md
- ❓ FAQ : faq.md


- Quick start: quickstart.md
- Features: features.md
- Cookbook: cookbook.md
- Tutorial: notebooks/tutorial.ipynb
- Performance: performance.md
- API reference: api.md

plugins:
- search
Expand Down

0 comments on commit 46e4c66

Please sign in to comment.