ssb-befolkning-fagfunksjoner 0.1.0

Befolkning Fagfunksjoner

Befolkning Fagfunksjoner

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

Features

• TODO

Requirements

• TODO

Installation

poetry add ssb-befolkning-fagfunksjoner

Usage

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.