Skip to main content

A Python package built on top of KLASS's API for retrieving classifications, codes, correspondences etc.

Project description

ssb-klass-python / KLASS

PyPI Status Python Version License

Documentation Tests Coverage Quality Gate Status

pre-commit Black Ruff Poetry

A Python package built on top of Statistics Norway's code- and classification-system "KLASS".
The package aims to make Klass's API for retrieving data easier to use by re-representing Klass's internal hierarchy as python-classes. Containing methods for easier traversal down, search classes and widgets, reasonable defaults to parameters etc. Where data is possible to fit into pandas DataFrames, this will be preferred, but hiererachical data / objects containing metadata will be kept as json / dict structure.

Installing

The package is available on Pypi, and can be installed by for example poetry like this:

poetry add ssb-klass-python

Example usages

Getting started

from klass import search_classification
# Opens a ipywidget in notebooks for searching for classifications and copying code, to get started
search_classification(no_dupes=True)

The GUI available through the search_classification function

Getting a classification directly

from klass import get_classification # Import the utility-function
nus = get_classification(36)
# Does the same as the code above, but does not shy away from using the class directly
from klass import KlassClassification # Import the class for KlassClassifications
nus = KlassClassification(36)  # Use ID for classification

When you have the classification stored in an object, you can "dig into" the API from there.

codes = nus.get_codes() # codes from current date
print(codes)
codes.data  # Pandas dataframe available under the .data attribute

From searching through "families", down to a specific codelist

from klass import KlassSearchFamilies
search = KlassSearchFamilies(360)
print(search)
>>> "Family ID: 20 - Utdanning - Number of classifications: 5"
utdanning = search.get_family(20)
print(utdanning)
>>> "The Klass Family "Utdanning" has id 20."
>>> "And contains the following classifications:"
>>>  "36: Standard for utdanningsgruppering (NUS)"
nus = utdanning.get_classification(36)
print(nus)
>>> "Classification 36: Standard for utdanningsgruppering (NUS)..."
nus_codes = nus.get_codes("2023-01-01")
print(nus_codes)
>>> "Codelist for classification: 36"
>>> " From date: 2023-01-01"
nus_codes.data  # A pandas dataframe

For more examples check out the demo-notebooks in the demo/ folder in the repo.

Technical notes

Documentation for the endpoints we are using can be found on Statistics Norways pages.

Technical architecture of the API we are interacting with is detailed in Statistics Norway's internal wiki.

This project has been migrated to follow the SSB PyPI Template from Statistics Norway.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ssb_klass_python-0.0.11.tar.gz (27.2 kB view details)

Uploaded Source

Built Distribution

ssb_klass_python-0.0.11-py3-none-any.whl (33.0 kB view details)

Uploaded Python 3

File details

Details for the file ssb_klass_python-0.0.11.tar.gz.

File metadata

  • Download URL: ssb_klass_python-0.0.11.tar.gz
  • Upload date:
  • Size: 27.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.4

File hashes

Hashes for ssb_klass_python-0.0.11.tar.gz
Algorithm Hash digest
SHA256 7678dca4e9178889c97b5fd3161a7afca99f840bf898777f40ff6d6b08fd0deb
MD5 d0ce021d0606a16325ef4335339a3a40
BLAKE2b-256 0e59b272a5c17374caa039ae6d217cf3f2ad0baf748400476c4b3b92cdc68963

See more details on using hashes here.

File details

Details for the file ssb_klass_python-0.0.11-py3-none-any.whl.

File metadata

File hashes

Hashes for ssb_klass_python-0.0.11-py3-none-any.whl
Algorithm Hash digest
SHA256 7a560764d44d3f84cea5eca922bda4fa7c2bea2421e8495be473acc0ce4c58cb
MD5 713a489b069289c35a971bb040338544
BLAKE2b-256 028949a248072f6884d19152ffbc3a04eda4cc51cdaff2deef8c2ae7731243f2

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page