Befolkning Fagfunksjoner

Collection of python functions used in statistics production in the Division for Population Statistics at Statistics Norway.

Features

• TODO

Requirements

• TODO

Installation

To install the core library:

poetry add ssb-befolkning-fagfunksjoner

If you need SAS session support (which requires Java and a SAS installation), install the optional sas extra:

poetry add ssb-befolkning-fagfunksjoner -E sas

(If using pip, use pip install ssb-befolkning-fagfunksjoner[sas])

Usage

Optional features are imported identically to standard modules, but will raise a detailed ImportError pointing to the required extra if you attempt to use them without installing it first.

Reference Guide

The library's utilities are grouped into structured submodule namespaces. Here is a quick reference cheat sheet:

EventParams

EventParams contains logic for:

• Prompting and validating parameters for event periods
• Creating period labels
• Computing calendar window for the chosen period
• Exposing event parameters for parameterising SQL queries

Supported period types are:

• year
• halfyear (1-2)
• quarter (1-4)
• month (1-12)
• week (ISO week, 1-53)

The class can be constructed with explicit arguments in code:

from ssb_befolkning_fagfunksjoner import EventParams

# Example: March 2024, with default wait period (1 month, 0 days)
params = EventParams(
    year=2024,
    period_type="month",
    period_number=3,
    specify_wait_period=False,  # default; can be omitted
)

If input arguments are omitted, the user will be prompted:

• year: prompts for an integer between 1900 and current year
• period_type: prompts for a valid period type
  • Accepts both full names ("quarter", "month", etc.) and single-letter abbreviations ("q", "m", etc.)
• period_number: prompted only when needed, with appropriate range checks (e.g. 1-12 for months)

from ssb_befolkning_fagfunksjoner import EventParams

# Will ask the user for missing values in the terminal
params = EventParams()

Once the class is constructed, get the period label as follows:

# Example: March 2024, with default wait period
period_label = params.period_label
# "p2024-03"

Get the start and end dates of the period using the window property:

# Example: March 2024, with default wait period
start_date, end_date = params.window
# datetime.date(2024, 3, 1), datetime.date(2024, 3, 31)

Get a dict used for parameterising SQL-queries:

sql_param = params.to_query_params()
# {
#   "start_date": datetime.date(2024, 3, 1),
#   "end_date": datetime.date(2024, 3, 31),
#   "etterslep_start": datetime.date(2024, 4, 1),
#   "etterslep_end": datetime.date(2024, 4, 30)
# }

Demographics

KLASS utils

Kommnr

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the MIT license, Befolkning Fagfunksjoner is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from Statistics Norway's SSB PyPI Template.