How To Use SCODA

SCODA can be used to:

  1. Obtain City Indicators
  2. Access City Dashboards
  3. View Data Stories.

A. Obtain City Indicators

City Indicators are a set of data developed and adopted by cities seeking to measure and monitor various aspects of city development. Indicators include raw data and manipulated data in excel sheets and are mainly understood by data scientists.

The process of obtaining city indicators on SCODA

  1. Click on

  2. You will be redirected to the Data Portal which shows all datasets uploaded to the SCODA database.

  3. Examples of a Data Set: Click on “State of Cities Report 2016” to access that collection of datasets.

    1. You will be directed to the dataset collection for “State of Cities Report 2016”.

    2. From this list, choose which dataset you would like to download. In this example we have selected the dataset called: “Inclusive Cities Data”

  4. This is an example of what a downloaded dataset and its format look like:

B. Access City Dashboards

City dashboards are a visual way to showcase municipal measures and progress. Dashboards are used to profile a city and provide an overview of city development according to a set of key areas e.g. levels of education in a city, access to social services, city finance, economic development, etc. Dashboards are useful for those involved in policy development, researchers, data scientist, and anybody interested in an overview of their city’s development.

The process of accessing city dashboards on SCODA

  1. Click on

  2. You will be directed to the SCODA landing page.
    Scroll down to the map at the bottom of the page. In this example we have selected the “City of Tshwane”

  3. When you have selected a city, a City Profile pops up.
    To view the City Dashboard, scroll down on the city profile pop up and select: “Click Here” under the heading: City Dashboard.

  4. The relevant City Dashboard will open in a new browser tab as a downloadable PDF.

C. View Data Stories

Showing city indicators and dashboards can be overwhelming for people that are not data scientists or policy makers without adding a narrative to the data. Dashboards and spreadsheets only tell you what is happening. But, they do not tell you why. Data storytelling is a methodology for communicating information, tailored to a specific audience, with a compelling narrative.

The process of viewing a data story

  1. Click on

  2. You will be redirected to the SCODA landing page.

  3. On the landing page, choose one of the data stories.
    In this example we have selected: “State of City Finances 2018: Financing Infrastructure.

  4. The relevant Data Story will open in a pop up window like the following example.