semvec/pypi-packages huggingface dataset:
osm2gmns 1.0.1
convert map data from OpenStreetMap to network files in GMNS format
Requires Python: >=3.8

osm2gmns
====================================
| **Authors**: `Jiawei Lu`_, `Xuesong (Simon) Zhou`_
| **Email**: lujiaweiwk@gmail.com, xzhou74@asu.edu


osm2gmns is a high-performance Python package designed to convert `OpenStreetMap`_ (OSM) 
data into standardized transportation networks. Leveraging a C++ core wrapped in an 
intuitive Python interface, osm2gmns offers both computational speed and ease of use. 
**It empowers researchers and practitioners to generate detailed, multi-modal networks (driving, cycling, walking, railway, aeroway) for any region worldwide with minimal coding effort**.

The package outputs networks primarily in the `GMNS`_ (General Modeling Network Specification) 
format, promoting interoperability and simplifying data exchange within the transportation 
modeling community.

.. code-block:: python

    >>> import osm2gmns as og
    >>> net = og.getNetFromFile('map.osm')
    >>> og.outputNetToCSV(net)


*This v1.x version introduces significant architectural changes, performance improvements, and new features compared to* `v0.x`_, *and is not fully backward compatible*.

- *We encourage users to adopt v1.x for the latest capabilities and ongoing development*.
- *v0.x will only receive critical bug fixes moving forward*.
- *Functionality like Multi-Resolution Modeling (MRM), currently available only in v0.x, is planned for future v1.x releases*.


Citation
====================================

If osm2gmns contributes to your research, please cite the following publication:

Lu, J., & Zhou, X.S. (2023). Virtual track networks: A hierarchical modeling framework and 
open-source tools for simplified and efficient connected and automated mobility (CAM) system 
design based on general modeling network specification (GMNS). Transportation Research 
Part C: Emerging Technologies, 153, 104223. [`link`_]


User's guide
====================================

Users are referred to `user's guide`_ for a detailed introduction of osm2gmns.



.. _`Jiawei Lu`: https://www.linkedin.com/in/jiawlu/
.. _`Xuesong (Simon) Zhou`: https://www.linkedin.com/in/xzhou/
.. _`OpenStreetMap`: https://www.openstreetmap.org
.. _`GMNS`: https://github.com/zephyr-data-specs/GMNS
.. _`v0.x`: https://osm2gmns.readthedocs.io/en/v0.x
.. _`link`: https://doi.org/10.1016/j.trc.2023.104223
.. _`user's guide`: https://osm2gmns.readthedocs.io
olostep-sdk 0.1.2
Official Python SDK for Olostep Web Scraping API
Requires Python: >=3.7

# Olostep SDK

A lightweight Python SDK for interacting with the Olostep scraping, crawling, and batching API.

## 🚀 Installation

Install from PyPI:

    pip install olostep-sdk

## 🧰 Features

- Scrape single URLs with different parsers
- Batch process multiple items
- Crawl starting from a URL
- Retrieve and parse content in multiple formats (JSON, Markdown, etc.)

## 🔑 Getting Started

First, initialize the SDK with your API token:

    from olostep_sdk import OlostepClient
    from olostep_sdk.services.scrape import ScrapeService
    from olostep_sdk.enums import OlostepParser, Format

    client = OlostepClient(api_token="your-api-token")
    scraper = ScrapeService(client)

### 🔍 Scrape a URL

    result = scraper.scrape(
        url="https://example.com",
        parser=OlostepParser.GOOGLE_SEARCH
    )
    print(result)

### 📦 Start a Batch

    from olostep_sdk.services.batch import BatchService

    batch = BatchService(client)
    batch_id = batch.start_batch([
        {"url": "https://example1.com"},
        {"url": "https://example2.com"}
    ])
    batch.wait_until_complete(batch_id)
    items = batch.get_items(batch_id)

### 🌐 Crawl a Website

    from olostep_sdk.services.crawl import CrawlService

    crawler = CrawlService(client)
    crawl_id = crawler.start_crawl("https://example.com")
    crawler.wait_until_complete(crawl_id)
    results = crawler.get_items(crawl_id)

## 📄 Formats and Parsers

    from olostep_sdk.enums import Format, OlostepParser

    Format.MARKDOWN
    Format.JSON

    OlostepParser.GOOGLE_SEARCH
    OlostepParser.BASIC

## 🧪 Running Tests

    python -m unittest discover -s tests

## 📬 License

This project is licensed under the MIT License.