Skip to content

Model updates for v4.0.0 and changes to population variants table and… #242

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.

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

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

DCEW
Copy link
Contributor

@DCEW DCEW commented Jul 4, 2025

… text

Added model updates section for the population projections changes and API/code restructure. Also made relevant modifications to the text of the demographic modelling chapter to reflect the currently available subnational variants.

Draft until James S has had a chance to proof read the model updates section.

closes #239

@DCEW DCEW requested review from tomjemmett and matt-dray July 4, 2025 10:18
@DCEW DCEW self-assigned this Jul 4, 2025
@DCEW
Copy link
Contributor Author

DCEW commented Jul 4, 2025

The model updates text has now be okayed by James Sandy, with a few minor alterations that have been incorporated into this PR.

@DCEW DCEW marked this pull request as ready for review July 4, 2025 13:28
@DCEW DCEW requested review from yiwen-h and ChrisBeeley as code owners July 4, 2025 13:28
Copy link
Member

@ChrisBeeley ChrisBeeley left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM- would be good to have more eyes on it before release

Copy link
Member

@tomjemmett tomjemmett left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

see comments, but otherwise looks fine


Sub-national population projections include four variant projections based on different assumptions about migration levels and trends. To provide a wider range of demographic scenarios for use in the model we create a custom set of sub-national variant projections using the [17 national variant projections produced by the ONS](https://www.ons.gov.uk/peoplepopulationandcommunity/populationandmigration/populationprojections/methodologies/variantnationalpopulationprojectionsfortheukandsubnationalpopulationprojectionsandhouseholdprojectionsforenglanduserguide). We do this by applying growth rates by age, sex, and year from the national variant projections to the base population for each LAD from the sub-national projections.

Where a national variant is based on the same set of assumptions as a sub-national variant, we prefer the sub-national version. The [complete set of projections](list_of_projections.qmd) available to the model is available in this documentation and includes 19 variants alongside the principal projection.
Where a national variant is based on the same set of assumptions as a sub-national variant, we prefer the sub-national version. The [complete set of projections](list_of_projections.qmd) available to the model is available in this documentation and includes 17 variants alongside the main ('migration category') projection.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

as we are no longer using the national variants, is this redundant?


### Code restructure and new API

We have restructured our model code base significantly for this release and have also created a new Application Programme Interface (API) for the model.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the new-API is really just the old-API... there are some techincal reasons relating to switching internally (basically, newer features in Azure that required a complete re-deployment).

that, and the API is there purely from a data security perspective, it doesn't have any impact on the project otherwise.

So I probably wouldn't mention this.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed. If we're not mentioning new server then why mention new API

Copy link
Member

@yiwen-h yiwen-h left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

4.0.0 update also needs to include information about the change of tretspef column names (#237) - or is this coming in a separate PR?

Minor, but we prefer ' to ‘ and ’

These are 2022-based projections by single year of age and sex for Local Authorities.
The ONS have advised that, due to more recently updated migration data becoming available, their ‘migration variant’ should now be used as the new ‘principal projection’, as this is a better reflection of short-term population change.

The earliest baseline year that models can use based on this change is now 2023.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The earliest baseline year that models can use based on this change is now 2023.
The only baseline year that models can use based on this change is now 2023.

@yiwen-h
Copy link
Member

yiwen-h commented Jul 7, 2025

If we are removing national projections then the info in this update is wrong and needs to be corrected. see https://github.com/The-Strategy-Unit/nhp_planning/issues/346#issuecomment-3043941297 for list of variants for v4.0

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Comms for updated subnational population projections
4 participants