semvec/pypi-packages huggingface dataset:
allocator 1.1.0
Modern Python package for geographic task allocation, clustering, and routing optimization
Requires Python: >=3.11
Keywords: geographic, allocation, clustering, routing, optimization, tsp, kmeans, geospatial, logistics, shortest-path

# allocator: Efficiently collect data from geographically distributed locations

[![PyPI version](https://img.shields.io/pypi/v/allocator.svg)](https://pypi.python.org/pypi/allocator)
[![Downloads](https://pepy.tech/badge/allocator)](https://pepy.tech/project/allocator)
[![CI](https://github.com/geosensing/allocator/actions/workflows/ci.yml/badge.svg)](https://github.com/geosensing/allocator/actions/workflows/ci.yml)
[![Documentation](https://img.shields.io/badge/docs-github.io-blue)](https://geosensing.github.io/allocator/)

**Allocator** provides a modern, Pythonic API for geographic task allocation, clustering, and routing optimization.

## Key Features

- **🎯 Clustering**: Group geographic points into balanced zones
- **🛣️ Routing**: Find optimal paths through locations (TSP solving)  
- **📍 Assignment**: Connect points to closest workers/centers
- **🚀 Performance**: Optimized algorithms with NumPy and scikit-learn
- **📦 Modern API**: Clean Python interface + unified CLI

## Quick Start

```bash
pip install allocator
```

```python
import allocator
import pandas as pd

# Geographic locations
locations = pd.DataFrame({
    'longitude': [100.5018, 100.5065, 100.5108],
    'latitude': [13.7563, 13.7590, 13.7633]
})

# Group into zones
clusters = allocator.cluster(locations, n_clusters=2)

# Find optimal route
route = allocator.shortest_path(locations)

# Assign to service centers
centers = pd.DataFrame({
    'longitude': [100.50, 100.52],
    'latitude': [13.75, 13.77]
})
assignments = allocator.assign(locations, centers)
```

## Documentation & Examples

- **📖 [Full Documentation](https://geosensing.github.io/allocator/)**
- **🚀 [Installation & Tutorial](https://geosensing.github.io/allocator/quickstart.html)**  
- **🔧 [API Reference](https://geosensing.github.io/allocator/api/clustering.html)**
- **💡 [Real-World Examples](https://geosensing.github.io/allocator/examples/overview.html)**

## License & Contributing

MIT License. Contributions welcome - see [Contributing Guide](https://geosensing.github.io/allocator/contributing.html).
easy-use-tools 1.0.6
An easy use tools package
Requires Python: >=3.8

# 通用工具集
这是一个通用工具集, 适用于>=Python3.8

## 1. 准备
### 1.1 安装依赖
```
pip3 install --upgrade packaging setuptools wheel twine
```

## 2. 命令说明

### 2.1 打包
```
python3 setup.py sdist bdist_wheel
```
在当前dist目录下的两个文件是要上传到 PyPi 网站上供别人下载安装的（*.tar.gz、*.whl）

### 2.2 配置文件检查
```
python3 setup.py check
```

### 2.3 上传前检查
```
twine check dist/*
```
### 2.5 执行上传
```
twine upload dist/*
```
### 2.6清理
```
rm -rf build/ dist/ *.egg-info/
```
## 3. 其他说明
- 本地安装使用(本地安装而不使用pip安装)
```
python3 setup.py install
```
- 安装此工具包
```
pip3 install easy_use_tools -i https://pypi.org/simple/
```
- 升级此工具包
```
pip3 install --upgrade easy_use_tools -i https://pypi.org/simple/
```
## 4. 使用说明
详见当前项目的README_USE.md文件