Skip to main content

WARNING 08/01/2026: Please note that this project is not currently being actively maintained. Some functions may no longer work.

Next scheduled review date: 08/01/2027 QA status: Package is currently failing some tests.

fingertips_py

This is a python package to interact with OHID's Fingertips data tool. Fingertips is a major repository of population and public health indicators for England. The site presents the information in many ways to improve accessibility for a wide range of audiences ranging from public health professionals and researchers to the general public. The information presented is a mixture of data available from other public sources, and those that are available through user access agreements with other organisations. The source of each indicator presented is available using the get_metadata_for_indicator() function.

This package can be used to load data from the Fingertips API into python for further use.

Installation

This packaged should be installed using pip:

pip install fingertips_py

Or it can be compiled from source (still requires pip):

pip install git+https://github.com/dhsc-govuk/fingertips_py.git

Usage

fingertips_py should be imported and used in line with standard python conventions. It is suggested that if the whole package is to be imported then the following convention is used:

import fingertips_py as ftp

The package returns data in a variety of types dependent on the function.

For more information on any function, you can use:

help(*fingertips_py function name*)

Or you can view the documents here.

Example

This is an example of a workflow for retrieving data for the indicator on Healthy Life Expectancy at Birth from the Public Health Outcomes Framework profile.

import fingertips_py as ftp


phof = ftp.get_profile_by_name('public health outcomes framework')
phof_meta = ftp.get_metadata_for_profile_as_dataframe(phof['Id'])
indicator_meta = phof_meta[phof_meta['Indicator'].str.contains('Healthy')]
print(indicator_meta)

    Indicator ID                                          Indicator  ...   
0          90362            0.1i - Healthy life expectancy at birth  ... 
55         92543  2.05ii - Proportion of children aged 2-2½yrs r...  ...

We can see that the Healthy life expectancy at birth indicator has an id of 90362. The data for this indicator at all geographical breakdowns can be retrieved using get_data_for_indicator_at_all_available_geographies()

healthy_life_data = ftp.get_data_for_indicator_at_all_available_geographies(90362)

Licence

This project is released under the GPL-3 licence.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fingertips_py-0.4.3.tar.gz (49.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fingertips_py-0.4.3-py3-none-any.whl (36.3 kB view details)

Uploaded Python 3

File details

Details for the file fingertips_py-0.4.3.tar.gz.

File metadata

  • Download URL: fingertips_py-0.4.3.tar.gz
  • Upload date:
  • Size: 49.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for fingertips_py-0.4.3.tar.gz
Algorithm Hash digest
SHA256 86c2645821a9bb4bf7fee8051e29c0b676b661416022bde6692c5d071da1b4f5
MD5 1e8b828dab8575420ad2f8c347209a00
BLAKE2b-256 6a73db65ce3840069b50e906a1b206879a81c78d183baa5186bd900679c5af0c

See more details on using hashes here.

Provenance

The following attestation bundles were made for fingertips_py-0.4.3.tar.gz:

Publisher: pypi.yml on dhsc-govuk/fingertips_py

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file fingertips_py-0.4.3-py3-none-any.whl.

File metadata

  • Download URL: fingertips_py-0.4.3-py3-none-any.whl
  • Upload date:
  • Size: 36.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for fingertips_py-0.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 a4e27de9691eded596eb9555fedd78476cba4f6b5c7630c601f336d9294db398
MD5 8e5c95b437775d164790649722f94ecf
BLAKE2b-256 482c8f50ff6a0aeadec77402f13f48fb9b6770a4f8e358b3e0185837934994df

See more details on using hashes here.

Provenance

The following attestation bundles were made for fingertips_py-0.4.3-py3-none-any.whl:

Publisher: pypi.yml on dhsc-govuk/fingertips_py

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page