Metadata-Version: 2.3
Name: plotly-kz-map
Version: 0.0.2.post1
Summary: A Python package that provides a simple interface to create Kazakhstan maps using Plotly
Project-URL: Homepage, https://github.com/aidoskanapyanov/plotly-kz-map
Project-URL: Issues, https://github.com/aidoskanapyanov/plotly-kz-map/issues
Project-URL: Source, https://github.com/aidoskanapyanov/plotly-kz-map
Author-email: Aidos Kanapyanov <aidos.kanapyanov2@gmail.com>
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Requires-Dist: geopandas>=1.0.0
Requires-Dist: plotly>=5.0.0
Description-Content-Type: text/markdown

# Plotly Kazakhstan Map

`plotly_kz_map` — is a Python package that provides a simple interface to create
Kazakhstan maps using [Plotly](https://github.com/plotly/plotly.py).

## Installation

```bash
pip install plotly-kz-map
```

## Features

- Drop in replacement for Plotly `choropleth` function, but with Kazakhstan
  regions support.

## Example

Here is an example using `plotly_kz_map` to visualize the population
of Kazakhstan by regions.

```python
import plotly_kz_map as px

# load a sample dataset as a pandas DataFrame
df = px.data.kazakhstan_population()

fig = px.choropleth(
    locations=df.region,
    locationmode="KZ-regions",
    color=df.population,
)

fig.show()
```

![Plotly Kazakhstan Map continuous](https://github.com/aidoskanapyanov/plotly-kz-map/blob/main/images/plotly-kz-map-continuous.png?raw=true)

Or you can use a discrete color scale:

```python
import plotly_kz_map as px

# load a sample dataset as a pandas DataFrame
df = px.data.kazakhstan_population()

fig = px.choropleth(
    locations=df.region,
    locationmode="KZ-regions",
    color=df.region,
)

fig.show()
```

![Plotly Kazakhstan Map discrete](https://github.com/aidoskanapyanov/plotly-kz-map/blob/main/images/plotly-kz-map-discrete.png?raw=true)

## Notes

`locations` keyword argument should be a list of region names abbreviated as
following (check `px.data.kazakhstan_population().region` to see the full list):

```python
{
    "ABY": "Abay Region",
    "AKM": "Akmola Region",
    "AKT": "Aktobe Region",
    "ALR": "Almaty Region",
    "ATY": "Atyrau Region",
    "EKR": "East Kazakhstan Region",
    "JMB": "Jambyl Region",
    "JTS": "Jetisu Region",
    "KGD": "Karaganda Region",
    "KST": "Kostanay Region",
    "KZY": "Kyzylorda Region",
    "MNG": "Mangystau Region",
    "NKR": "North Kazakhstan Region",
    "PVD": "Pavlodar Region",
    "TRK": "Turkistan Region",
    "ULY": "Ulytau Region",
    "WKR": "West Kazakhstan Region",
    "ALA": "Almaty",
    "AST": "Astana",
    "SHY": "Shymkent",
}
```

## License

[MIT](LICENSE)
