bolster.data_sources.nisra

NISRA (Northern Ireland Statistics and Research Agency) Data Sources.

This package provides access to statistical datasets published by NISRA, including births, deaths, labour market, population, migration, economic indicators, and tourism statistics.

Available modules:

  • ashe: Annual Survey of Hours and Earnings (employee earnings statistics)

  • births: Monthly birth registrations by registration and occurrence date

  • business_register: NI Business Register (IDBR) — annual VAT/PAYE business counts by industry, legal status, LGD

  • claimant_count: Monthly Claimant Count (UC + JSA) by sex, age, and geography

  • composite_index: Northern Ireland Composite Economic Index (experimental quarterly economic indicator)

  • construction_output: Quarterly construction output statistics (all work, new work, repair & maintenance)

  • deaths: Weekly death registrations with demographic, geographic, and place breakdowns

  • deprivation: NI Multiple Deprivation Measure 2017 (NIMDM) — SOA-level overall and domain deprivation ranks

  • drug_related_deaths: Annual drug-related and drug misuse deaths by year, age, gender, and substance

  • index_of_services: Quarterly Index of Services (IOS) — canonical module

  • index_of_production: Quarterly Index of Production (IOP) — canonical module

  • labour_market: Quarterly Labour Force Survey statistics (employment, economic inactivity)

  • marriages: Monthly marriage registrations

  • migration: Official and derived migration estimates (demographic components)

  • population: Annual mid-year population estimates by age, sex, and geography

  • planning_statistics: NI Planning Activity Statistics - quarterly applications, by council

  • population_projections: Population projections by age, sex, and geography (2022-2072)

  • registrar_general: Registrar General Quarterly Tables (quarterly births, deaths, marriages, LGD breakdowns)

  • baby_names: Annual baby name registrations (1997–present) by sex and rank

  • tourism: Tourism statistics including occupancy surveys, visitor stats (subpackage)

  • wellbeing: Individual wellbeing statistics (life satisfaction, happiness, anxiety, loneliness)

  • work_quality: Work Quality NI — seventeen indicators of job quality for employees

  • housing_stock: NI Housing Stock annual statistics by property type (DoF/LPS)

  • public_confidence: Public Awareness of and Trust in Official Statistics (PCOS)

Note

Health and Social Care (DoH) data sources previously in this package have been moved to bolster.data_sources.health_ni: cancer_waiting_times, child_protection, diagnostic_waiting_times, disease_prevalence, elective_waiting_times, emergency_care_waiting_times.

Examples

>>> from bolster.data_sources.nisra import claimant_count
>>> cc_df = claimant_count.get_latest_claimant_count("headline")
>>> "claimants_000s" in cc_df.columns
True

>>> from bolster.data_sources.nisra import ashe
>>> earnings_df = ashe.get_latest_ashe_timeseries('weekly')
>>> 'median_weekly_earnings' in earnings_df.columns
True

>>> from bolster.data_sources.nisra import births
>>> birth_data = births.get_latest_births(event_type='both')
>>> 'births' in birth_data['registration'].columns
True

>>> from bolster.data_sources.nisra import composite_index
>>> nicei_df = composite_index.get_latest_nicei()
>>> 'nicei' in nicei_df.columns
True

>>> from bolster.data_sources.nisra import construction_output
>>> construction_df = construction_output.get_latest_construction_output()
>>> 'all_work_index' in construction_df.columns
True

>>> from bolster.data_sources.nisra import deaths
>>> df = deaths.get_latest_deaths(dimension='demographics')
>>> 'deaths' in df.columns
True

>>> from bolster.data_sources.nisra import deprivation
>>> df = deprivation.get_latest_data()
>>> 'mdm_rank' in df.columns
True

>>> from bolster.data_sources.nisra import index_of_services as ios
>>> ios_df = ios.get_latest_ios()
>>> 'ni_index' in ios_df.columns
True

>>> from bolster.data_sources.nisra import labour_market
>>> emp_df = labour_market.get_latest_employment()
>>> 'percentage' in emp_df.columns
True

>>> from bolster.data_sources.nisra import marriages
>>> marriages_df = marriages.get_latest_marriages()
>>> 'marriages' in marriages_df.columns
True

>>> from bolster.data_sources.nisra.tourism import occupancy
>>> occ_df = occupancy.get_latest_hotel_occupancy()
>>> 'room_occupancy' in occ_df.columns
True

>>> from bolster.data_sources.nisra import migration
>>> migration_df = migration.get_latest_migration()
>>> 'net_migration' in migration_df.columns
True

>>> from bolster.data_sources.nisra import registrar_general
>>> data = registrar_general.get_quarterly_vital_statistics()
>>> sorted(data.keys())
['births', 'deaths', 'lgd']

>>> from bolster.data_sources.nisra import population
>>> pop_df = population.get_latest_population(area='Northern Ireland')
>>> 'population' in pop_df.columns
True

>>> from bolster.data_sources.nisra import wellbeing
>>> df = wellbeing.get_latest_personal_wellbeing()
>>> 'life_satisfaction' in df.columns
True

>>> from bolster.data_sources.nisra import business_register
>>> df = business_register.get_latest_data()
>>> 'businesses' in df.columns
True

Submodules