Skip to content

Add Stats NZ 2023 Census household and family counts by regional council #335

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MaxGhenis merged 4 commits into from
Oct 11, 2026
Merged

Add Stats NZ 2023 Census household and family counts by regional council #335

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
9df0fbe
Add Stats NZ 2023 Census household and family counts by regional council
MaxGhenis Oct 10, 2026
88770ac
Record the hub's R2 publication of the 18 place-summary files
MaxGhenis Oct 10, 2026
f4bebe8
Address review r1 of #335: mark households Partial, cite #176, fix cl…
MaxGhenis Oct 11, 2026
ed49432
Merge origin/main into nzhub/b5 and re-pin the bundle additively
MaxGhenis Oct 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions changelog.d/176-census-household-structure.added.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
Add Stats NZ 2023 Census Place summaries package families for households,
tenure, household size, families and family type: 288 single-row published
counts across New Zealand, 16 regional councils and Area Outside Region.
Preserve all 18 complete CSVs once with receipt-pinned manifests and labelled
dimensions, while excluding percentages, other years and Māori-only sections.
Record the product's absent household-composition and social-renting splits,
unstated regional boundary vintage and the hub's R2 publication and
SHA-256 verification of the 18 objects on 2026-10-10.
106 changes: 106 additions & 0 deletions chronicle/source_package.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,112 @@
SOURCE_PACKAGE_SCHEMA_VERSION = schema_id("source_package")
SOURCE_PACKAGE_ALIASES = {
"stats-nz-household-net-worth-2024": Path("stats_nz/household_net_worth_2024"),
"stats-nz-census-2023-family-type": Path("stats_nz/census_2023_family_type"),
"stats-nz-census-2023-family-type-rc-01": Path(
"stats_nz/census_2023_family_type/rc_01"
),
"stats-nz-census-2023-family-type-rc-02": Path(
"stats_nz/census_2023_family_type/rc_02"
),
"stats-nz-census-2023-family-type-rc-03": Path(
"stats_nz/census_2023_family_type/rc_03"
),
"stats-nz-census-2023-family-type-rc-04": Path(
"stats_nz/census_2023_family_type/rc_04"
),
"stats-nz-census-2023-family-type-rc-05": Path(
"stats_nz/census_2023_family_type/rc_05"
),
"stats-nz-census-2023-family-type-rc-06": Path(
"stats_nz/census_2023_family_type/rc_06"
),
"stats-nz-census-2023-family-type-rc-07": Path(
"stats_nz/census_2023_family_type/rc_07"
),
"stats-nz-census-2023-family-type-rc-08": Path(
"stats_nz/census_2023_family_type/rc_08"
),
"stats-nz-census-2023-family-type-rc-09": Path(
"stats_nz/census_2023_family_type/rc_09"
),
"stats-nz-census-2023-family-type-rc-12": Path(
"stats_nz/census_2023_family_type/rc_12"
),
"stats-nz-census-2023-family-type-rc-13": Path(
"stats_nz/census_2023_family_type/rc_13"
),
"stats-nz-census-2023-family-type-rc-14": Path(
"stats_nz/census_2023_family_type/rc_14"
),
"stats-nz-census-2023-family-type-rc-15": Path(
"stats_nz/census_2023_family_type/rc_15"
),
"stats-nz-census-2023-family-type-rc-16": Path(
"stats_nz/census_2023_family_type/rc_16"
),
"stats-nz-census-2023-family-type-rc-17": Path(
"stats_nz/census_2023_family_type/rc_17"
),
"stats-nz-census-2023-family-type-rc-18": Path(
"stats_nz/census_2023_family_type/rc_18"
),
"stats-nz-census-2023-family-type-rc-99": Path(
"stats_nz/census_2023_family_type/rc_99"
),
"stats-nz-census-2023-households-by-region": Path(
"stats_nz/census_2023_households_by_region"
),
"stats-nz-census-2023-households-by-region-rc-01": Path(
"stats_nz/census_2023_households_by_region/rc_01"
),
"stats-nz-census-2023-households-by-region-rc-02": Path(
"stats_nz/census_2023_households_by_region/rc_02"
),
"stats-nz-census-2023-households-by-region-rc-03": Path(
"stats_nz/census_2023_households_by_region/rc_03"
),
"stats-nz-census-2023-households-by-region-rc-04": Path(
"stats_nz/census_2023_households_by_region/rc_04"
),
"stats-nz-census-2023-households-by-region-rc-05": Path(
"stats_nz/census_2023_households_by_region/rc_05"
),
"stats-nz-census-2023-households-by-region-rc-06": Path(
"stats_nz/census_2023_households_by_region/rc_06"
),
"stats-nz-census-2023-households-by-region-rc-07": Path(
"stats_nz/census_2023_households_by_region/rc_07"
),
"stats-nz-census-2023-households-by-region-rc-08": Path(
"stats_nz/census_2023_households_by_region/rc_08"
),
"stats-nz-census-2023-households-by-region-rc-09": Path(
"stats_nz/census_2023_households_by_region/rc_09"
),
"stats-nz-census-2023-households-by-region-rc-12": Path(
"stats_nz/census_2023_households_by_region/rc_12"
),
"stats-nz-census-2023-households-by-region-rc-13": Path(
"stats_nz/census_2023_households_by_region/rc_13"
),
"stats-nz-census-2023-households-by-region-rc-14": Path(
"stats_nz/census_2023_households_by_region/rc_14"
),
"stats-nz-census-2023-households-by-region-rc-15": Path(
"stats_nz/census_2023_households_by_region/rc_15"
),
"stats-nz-census-2023-households-by-region-rc-16": Path(
"stats_nz/census_2023_households_by_region/rc_16"
),
"stats-nz-census-2023-households-by-region-rc-17": Path(
"stats_nz/census_2023_households_by_region/rc_17"
),
"stats-nz-census-2023-households-by-region-rc-18": Path(
"stats_nz/census_2023_households_by_region/rc_18"
),
"stats-nz-census-2023-households-by-region-rc-99": Path(
"stats_nz/census_2023_households_by_region/rc_99"
),
"stats-nz-subnational-population-estimates-2025": Path(
"stats_nz/subnational_population_estimates_2025"
),
Expand Down
2 changes: 2 additions & 0 deletions db/data/stats_nz/census_2023_place_summaries/.gitattributes
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# Publisher exports are immutable, including CRLF line endings.
*.csv binary
25 changes: 25 additions & 0 deletions db/data/stats_nz/census_2023_place_summaries/manifest-nz.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
source_id: stats_nz
package_id: census_2023_place_summaries
dataset: census_2023_place_summaries
source_page: https://tools.summaries.stats.govt.nz/
table: '2023 Census Place summaries: families and households'
license: CC BY 4.0
attribution: Stats NZ
files:
2023:
filename: place-summaries-nz.csv
source_url: https://tools.summaries.stats.govt.nz/api/export-csv/newzealand/NZ/
final_url: https://tools.summaries.stats.govt.nz/api/export-csv/newzealand/NZ/
http_status: 200
sha256: 6b35e4339ab98bd85dcfa0d297f9bf2c88403327dfe70430513cb7c10b26d89b
size_bytes: 394086
fetched_at: '2026-10-10T20:12:00Z'
content_disposition_filename: place-summaries-new-zealand-20261011-080638.csv
place_code: NZ
place: New Zealand
storage:
r2:
provider: r2
bucket: ledger-raw
key: raw/nz/stats_nz/census_2023_place_summaries/2023/6b35e4339ab98bd85dcfa0d297f9bf2c88403327dfe70430513cb7c10b26d89b/place-summaries-nz.csv
uri: r2://ledger-raw/raw/nz/stats_nz/census_2023_place_summaries/2023/6b35e4339ab98bd85dcfa0d297f9bf2c88403327dfe70430513cb7c10b26d89b/place-summaries-nz.csv
25 changes: 25 additions & 0 deletions db/data/stats_nz/census_2023_place_summaries/manifest-rc-01.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
source_id: stats_nz
package_id: census_2023_place_summaries
dataset: census_2023_place_summaries
source_page: https://tools.summaries.stats.govt.nz/places/RC/northland-region
table: '2023 Census Place summaries: families and households'
license: CC BY 4.0
attribution: Stats NZ
files:
2023:
filename: place-summaries-rc-01.csv
source_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/1/
final_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/1/
http_status: 200
sha256: 7eb81d38c4b3837c21d056ac772b91b4397ee4c1b26146a665deb373d847520f
size_bytes: 410926
fetched_at: '2026-10-10T20:12:01Z'
content_disposition_filename: place-summaries-northland-region-20261011-091200.csv
place_code: '1'
place: Northland Region
storage:
r2:
provider: r2
bucket: ledger-raw
key: raw/nz/stats_nz/census_2023_place_summaries/2023/7eb81d38c4b3837c21d056ac772b91b4397ee4c1b26146a665deb373d847520f/place-summaries-rc-01.csv
uri: r2://ledger-raw/raw/nz/stats_nz/census_2023_place_summaries/2023/7eb81d38c4b3837c21d056ac772b91b4397ee4c1b26146a665deb373d847520f/place-summaries-rc-01.csv
25 changes: 25 additions & 0 deletions db/data/stats_nz/census_2023_place_summaries/manifest-rc-02.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
source_id: stats_nz
package_id: census_2023_place_summaries
dataset: census_2023_place_summaries
source_page: https://tools.summaries.stats.govt.nz/places/RC/auckland-region
table: '2023 Census Place summaries: families and households'
license: CC BY 4.0
attribution: Stats NZ
files:
2023:
filename: place-summaries-rc-02.csv
source_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/2/
final_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/2/
http_status: 200
sha256: 8146e6612b8a0434f021b02f096cd0befaa450fdab0f5c09325201586ae001bc
size_bytes: 409747
fetched_at: '2026-10-10T20:12:01Z'
content_disposition_filename: place-summaries-auckland-region-20261011-091008.csv
place_code: '2'
place: Auckland Region
storage:
r2:
provider: r2
bucket: ledger-raw
key: raw/nz/stats_nz/census_2023_place_summaries/2023/8146e6612b8a0434f021b02f096cd0befaa450fdab0f5c09325201586ae001bc/place-summaries-rc-02.csv
uri: r2://ledger-raw/raw/nz/stats_nz/census_2023_place_summaries/2023/8146e6612b8a0434f021b02f096cd0befaa450fdab0f5c09325201586ae001bc/place-summaries-rc-02.csv
25 changes: 25 additions & 0 deletions db/data/stats_nz/census_2023_place_summaries/manifest-rc-03.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
source_id: stats_nz
package_id: census_2023_place_summaries
dataset: census_2023_place_summaries
source_page: https://tools.summaries.stats.govt.nz/places/RC/waikato-region
table: '2023 Census Place summaries: families and households'
license: CC BY 4.0
attribution: Stats NZ
files:
2023:
filename: place-summaries-rc-03.csv
source_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/3/
final_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/3/
http_status: 200
sha256: d4f378940be75e0a138282bd55368b232e4eacb5ea347184f1b4b7abd2deb694
size_bytes: 407261
fetched_at: '2026-10-10T20:12:02Z'
content_disposition_filename: place-summaries-waikato-region-20261011-091201.csv
place_code: '3'
place: Waikato Region
storage:
r2:
provider: r2
bucket: ledger-raw
key: raw/nz/stats_nz/census_2023_place_summaries/2023/d4f378940be75e0a138282bd55368b232e4eacb5ea347184f1b4b7abd2deb694/place-summaries-rc-03.csv
uri: r2://ledger-raw/raw/nz/stats_nz/census_2023_place_summaries/2023/d4f378940be75e0a138282bd55368b232e4eacb5ea347184f1b4b7abd2deb694/place-summaries-rc-03.csv
25 changes: 25 additions & 0 deletions db/data/stats_nz/census_2023_place_summaries/manifest-rc-04.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
source_id: stats_nz
package_id: census_2023_place_summaries
dataset: census_2023_place_summaries
source_page: https://tools.summaries.stats.govt.nz/places/RC/bay-of-plenty-region
table: '2023 Census Place summaries: families and households'
license: CC BY 4.0
attribution: Stats NZ
files:
2023:
filename: place-summaries-rc-04.csv
source_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/4/
final_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/4/
http_status: 200
sha256: fc75a24d8538450f98c8a4485a6c7816fb3b5d697ea363ad55b6ca88bcfde739
size_bytes: 419296
fetched_at: '2026-10-10T20:12:02Z'
content_disposition_filename: place-summaries-bay-of-plenty-region-20261011-091202.csv
place_code: '4'
place: Bay of Plenty Region
storage:
r2:
provider: r2
bucket: ledger-raw
key: raw/nz/stats_nz/census_2023_place_summaries/2023/fc75a24d8538450f98c8a4485a6c7816fb3b5d697ea363ad55b6ca88bcfde739/place-summaries-rc-04.csv
uri: r2://ledger-raw/raw/nz/stats_nz/census_2023_place_summaries/2023/fc75a24d8538450f98c8a4485a6c7816fb3b5d697ea363ad55b6ca88bcfde739/place-summaries-rc-04.csv
25 changes: 25 additions & 0 deletions db/data/stats_nz/census_2023_place_summaries/manifest-rc-05.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
source_id: stats_nz
package_id: census_2023_place_summaries
dataset: census_2023_place_summaries
source_page: https://tools.summaries.stats.govt.nz/places/RC/gisborne-region
table: '2023 Census Place summaries: families and households'
license: CC BY 4.0
attribution: Stats NZ
files:
2023:
filename: place-summaries-rc-05.csv
source_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/5/
final_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/5/
http_status: 200
sha256: 82f57517ccd7a22f953dc6ea5137d5e8f70248f762674a85bd33e0f8cf34285c
size_bytes: 408338
fetched_at: '2026-10-10T20:12:03Z'
content_disposition_filename: place-summaries-gisborne-region-20261011-091203.csv
place_code: '5'
place: Gisborne Region
storage:
r2:
provider: r2
bucket: ledger-raw
key: raw/nz/stats_nz/census_2023_place_summaries/2023/82f57517ccd7a22f953dc6ea5137d5e8f70248f762674a85bd33e0f8cf34285c/place-summaries-rc-05.csv
uri: r2://ledger-raw/raw/nz/stats_nz/census_2023_place_summaries/2023/82f57517ccd7a22f953dc6ea5137d5e8f70248f762674a85bd33e0f8cf34285c/place-summaries-rc-05.csv
25 changes: 25 additions & 0 deletions db/data/stats_nz/census_2023_place_summaries/manifest-rc-06.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
source_id: stats_nz
package_id: census_2023_place_summaries
dataset: census_2023_place_summaries
source_page: https://tools.summaries.stats.govt.nz/places/RC/hawkes-bay-region
table: '2023 Census Place summaries: families and households'
license: CC BY 4.0
attribution: Stats NZ
files:
2023:
filename: place-summaries-rc-06.csv
source_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/6/
final_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/6/
http_status: 200
sha256: ecd9485974efcc936ebacc452647b2597e6f37cf6386d328c88587fba66dcc46
size_bytes: 414894
fetched_at: '2026-10-10T20:12:04Z'
content_disposition_filename: place-summaries-hawke's-bay-region-20261011-091204.csv
place_code: '6'
place: Hawke's Bay Region
storage:
r2:
provider: r2
bucket: ledger-raw
key: raw/nz/stats_nz/census_2023_place_summaries/2023/ecd9485974efcc936ebacc452647b2597e6f37cf6386d328c88587fba66dcc46/place-summaries-rc-06.csv
uri: r2://ledger-raw/raw/nz/stats_nz/census_2023_place_summaries/2023/ecd9485974efcc936ebacc452647b2597e6f37cf6386d328c88587fba66dcc46/place-summaries-rc-06.csv
25 changes: 25 additions & 0 deletions db/data/stats_nz/census_2023_place_summaries/manifest-rc-07.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
source_id: stats_nz
package_id: census_2023_place_summaries
dataset: census_2023_place_summaries
source_page: https://tools.summaries.stats.govt.nz/places/RC/taranaki-region
table: '2023 Census Place summaries: families and households'
license: CC BY 4.0
attribution: Stats NZ
files:
2023:
filename: place-summaries-rc-07.csv
source_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/7/
final_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/7/
http_status: 200
sha256: 96ff9f1943d9200a3096b965bc510e1b369016128388ac43a202504d99fa986f
size_bytes: 408612
fetched_at: '2026-10-10T20:12:04Z'
content_disposition_filename: place-summaries-taranaki-region-20261011-091204.csv
place_code: '7'
place: Taranaki Region
storage:
r2:
provider: r2
bucket: ledger-raw
key: raw/nz/stats_nz/census_2023_place_summaries/2023/96ff9f1943d9200a3096b965bc510e1b369016128388ac43a202504d99fa986f/place-summaries-rc-07.csv
uri: r2://ledger-raw/raw/nz/stats_nz/census_2023_place_summaries/2023/96ff9f1943d9200a3096b965bc510e1b369016128388ac43a202504d99fa986f/place-summaries-rc-07.csv
25 changes: 25 additions & 0 deletions db/data/stats_nz/census_2023_place_summaries/manifest-rc-08.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
source_id: stats_nz
package_id: census_2023_place_summaries
dataset: census_2023_place_summaries
source_page: https://tools.summaries.stats.govt.nz/places/RC/manawatu-whanganui-region
table: '2023 Census Place summaries: families and households'
license: CC BY 4.0
attribution: Stats NZ
files:
2023:
filename: place-summaries-rc-08.csv
source_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/8/
final_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/8/
http_status: 200
sha256: c693e64b4194d507647b5ba35af4675df9fb44af64de40fd1ce399a37af396b5
size_bytes: 431319
fetched_at: '2026-10-10T20:12:05Z'
content_disposition_filename: place-summaries-manawatu-whanganui-region-20261011-072623.csv
place_code: '8'
place: Manawatū-Whanganui Region
storage:
r2:
provider: r2
bucket: ledger-raw
key: raw/nz/stats_nz/census_2023_place_summaries/2023/c693e64b4194d507647b5ba35af4675df9fb44af64de40fd1ce399a37af396b5/place-summaries-rc-08.csv
uri: r2://ledger-raw/raw/nz/stats_nz/census_2023_place_summaries/2023/c693e64b4194d507647b5ba35af4675df9fb44af64de40fd1ce399a37af396b5/place-summaries-rc-08.csv
25 changes: 25 additions & 0 deletions db/data/stats_nz/census_2023_place_summaries/manifest-rc-09.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
source_id: stats_nz
package_id: census_2023_place_summaries
dataset: census_2023_place_summaries
source_page: https://tools.summaries.stats.govt.nz/places/RC/wellington-region
table: '2023 Census Place summaries: families and households'
license: CC BY 4.0
attribution: Stats NZ
files:
2023:
filename: place-summaries-rc-09.csv
source_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/9/
final_url: https://tools.summaries.stats.govt.nz/api/export-csv/rkTah6u2O2VYyP4Y/9/
http_status: 200
sha256: 38cc255b43303a31f45cdfbf2ba8c4b9c8e367eaaf50e76c1388d3085cc08900
size_bytes: 413326
fetched_at: '2026-10-10T20:12:06Z'
content_disposition_filename: place-summaries-wellington-region-20261011-091205.csv
place_code: '9'
place: Wellington Region
storage:
r2:
provider: r2
bucket: ledger-raw
key: raw/nz/stats_nz/census_2023_place_summaries/2023/38cc255b43303a31f45cdfbf2ba8c4b9c8e367eaaf50e76c1388d3085cc08900/place-summaries-rc-09.csv
uri: r2://ledger-raw/raw/nz/stats_nz/census_2023_place_summaries/2023/38cc255b43303a31f45cdfbf2ba8c4b9c8e367eaaf50e76c1388d3085cc08900/place-summaries-rc-09.csv
Loading
Loading