v4.8.0 (updates for improved policy checklist reporting)

[carlhiggs]

This is an important update with improvements for reporting of policy indicators, including:

• policy quality scores are now correctly presented with half-score decimal points where these are required (e.g. 16.5/62 was previously incorrectly truncated to16/62; this representation has been corrected) (Numerator in policy quality may display incorrectly rounded in reports #515 )
• if policies are not identified, the reporting checklist now records these as 'X' instead of '-' ('X' instead of '-' if a policy is not identified. #514)
• distinct summaries for policy, spatial, and policy-spatial combined reports can now be tailored for the respective templates (Report summaries should be customisable for each type (policy, spatial, combined) #513)
• a stand-alone function ghsci.generate_policy_report(xlsx, options) is now provided to allow generation of policy indicator reports without need to configure and analyse a study region (Standalone function to generate a policy report without configuring a study region #462)
• draft policy indicator reports can also now be generated as required from within the GHSCI app by selecting an xlsx file (however, customisation still requires command line usage) (Standalone function to generate a policy report without configuring a study region #462)

It is recommended that users who have generated policy reports using the updated templates (since October 2023) consider re-preparing their reports using the updated formatting. All users may consider regenerating reports to use customised summaries for the various policy and spatial indicator templates.

@MelanieLowe @healthysustainablecities/ghsci-software-working-group

Any questions about this release may be posted in the discussion post for this release on the Discussions page.

What's Changed

• Policy checks by @carlhiggs in Policy checks #516

Full Changelog: v4.7.3...v4.8.0

---

This discussion was created from the release v4.8.0.

[carlhiggs]

Note: shortly after this release, it was brought to my attention by @MelanieLowe that we had overlooked including the long-discussed and planned for update to reporting templates to present 'above the median' instead of 'below the median'. This release includes corrected translations, and some very minor updates to code to support their inclusion to use the alternate statistic (that was already calculated).

Example, was:

Example, now:

So, while 68.7+31.1=99.8 this simply implies that 0.2% of the population approximately live in areas matching the 25-city median reference statistic (i.e. not < or > this).

In the Las Palmas example, the below and above statistics actually sum to 100, which would be expected in most cities (its quite a coincidence to live in an area an exact match of the reference statistic).

Also, I incremented the software version number to match the release v4.8.1 --- I overlooked doing this in the previous release.