https://github.com/kmedian/grouplabelencode

Encode grouped/mapped labels
https://github.com/kmedian/grouplabelencode

pypi

Last synced: about 1 month ago
JSON representation

Encode grouped/mapped labels

• Host: GitHub
• URL: https://github.com/kmedian/grouplabelencode
• Owner: kmedian
• License: mit
• Created: 2018-10-02T09:59:30.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2019-12-01T11:38:18.000Z (about 5 years ago)
• Last Synced: 2024-12-16T13:56:44.482Z (2 months ago)
• Topics: pypi
• Language: Jupyter Notebook
• Size: 21.5 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Build Status](https://travis-ci.org/kmedian/grouplabelencode.svg?branch=master)](https://travis-ci.org/kmedian/grouplabelencode)

[![Binder](https://mybinder.org/badge.svg)](https://mybinder.org/v2/gh/kmedian/grouplabelencode/master?urlpath=lab)

[![Gitpod - Code Now](https://img.shields.io/badge/Gitpod-code%20now-blue.svg?longCache=true)](https://gitpod.io#https://github.com/kmedian/grouplabelencode)

# grouplabelencode

## Table of Contents

* [Installation](#installation)

* [Usage](#usage)

* [Commands](#commands)

* [Support](#support)

* [Contributing](#contributing)

## Installation

The `grouplabelencode` [git repo](http://github.com/kmedian/grouplabelencode) is available as [PyPi package](https://pypi.org/project/grouplabelencode)

```

pip install grouplabelencode

```

## Usage

```

from grouplabelencode import grouplabelencode

data = ['a', 'b', 3, 3, 'b', 'b', 'e', 'z', 'd', 'a', 'unknown']  # raw data

groups = [['a', 'b', 3], ['d', 'e']]  # mapping for 2 groups

encoded = grouplabelencode(data, groups, nastate=True)

print(encoded)

# [0, 0, 0, 0, 0, 0, 1, 2, 1, 0, 2]  # 2: NA state

```

Check the [examples](http://github.com/kmedian/grouplabelencode/examples) folder for notebooks.

## Commands

Install a virtual environment

```

python3 -m venv .venv  # see note below

source .venv/bin/activate

pip3 install --upgrade pip

pip3 install -r requirements.txt

pip3 install jupyterlab  # and other packages required for demo

```

(If your git repo is stored in a folder with whitespaces, then don't use the subfolder `.venv`. Use an absolute path without whitespaces.)

Python commands

* Jupyter for the examples: `jupyter lab`

* Check syntax: `flake8 --ignore=F401 --exclude=$(grep -v '^#' .gitignore | xargs | sed -e 's/ /,/g')`

* Run Unit Tests: `python -W ignore -m unittest discover`

* Upload to PyPi with twine: `python setup.py sdist && twine upload -r pypi dist/*`

Clean up 

```

find . -type f -name "*.pyc" | xargs rm

find . -type d -name "__pycache__" | xargs rm -r

rm -r .pytest_cache

rm -r .venv

```

## Debugging

* Notebooks to profile python code are in the [profile](profile) folder

## Support

Please [open an issue](https://github.com/kmedian/grouplabelencode/issues/new) for support.

## Contributing

Please contribute using [Github Flow](https://guides.github.com/introduction/flow/). Create a branch, add commits, and [open a pull request](https://github.com/kmedian/grouplabelencode/compare/).