Using Figure.NZ

Figure.NZ exists to make it easier for all New Zealanders to find and use figures about our country.

If you’re not sure what you might use figures for, or why, here are some ideas.

• To learn more about where you live, whether that’s Whangārei, Invercargill, or somewhere in between.
• To find out about a topic, like health, education, or our population.
• For work presentations and reports, or school projects — the right figures can go a long way to helping you make your point.

Read our guide to getting started with charts if you’d like some pointers.

All the data on figure.nz is free for you to use. You do need to:

• comply with the license terms of the original data provider. These are linked below each chart and table.
• follow our own reasonable terms and conditions.

You can find more detailed information on using our charts in our brand guidelines.

Getting started with charts

Charts are much easier to understand than tables full of numbers, but they can still be tricky to get your head around.

Visit Learn.Figure.NZ for friendly, easy-to-follow guides on using and understanding charts.

Use our data

We process data from many disparate formats and turn it into standardised machine-readable form. We publish all data in multiple formats, so you can use what works best for you.

If something doesn’t make sense please email us at data@figure.nz so we can make it clearer or fix any mistakes 😱.

Types of content

Charts

We have tens of thousands of charts for you to use. We make as many charts as we can from each dataset, because most people find charts easier to use and understand than raw data. All our charts are presented in a consistent form and follow our standards, including all relevant metadata (information that describes things about the data).

You can use our charts in your own work or share them with others using the tools built in to our website.

Tables

All the data we process and standardise is available in downloadable CSV tables — a file format used to store data, like a spreadsheet. We also publish metadata to accompany tables. Here’s a table about New Zealand’s estimated and projected age distribution by territorial authority 1981-2043.

Because there are so many tables on figure.nz, our website doesn’t display them by default, but you can see them by searching for a topic and then selecting the Tables tab at the top of the search results.

API

It’s important for us to make data we’ve processed available in the most useful and accessible ways possible. One way we’re considering for more technical users is a public API. If you’re someone who might like to use this, please get in touch using the details on our team page so we can include your needs in our thinking.

If “API” doesn’t mean anything to you, don’t worry, you’re not alone! The nutshell version is it stands for “Application Programming Interface”. An interface is where things meet. Beaches are an interface between land and sea; APIs are interfaces between different pieces of software. For a longer description you’re probably best to check out what Wikipedia says.

Metadata

Metadata is information that describes things about the data. This can include definitions of words, limitations on the data, why the data was collected, who collected it, and how to locate the original files.

Metadata is attached to every element of every piece of data we publish, down to the individual cell in every table. We publish a summary of the metadata we have on every chart, map and table page on our site.

Crediting Figure.NZ content

• Find the correct licensing details for the chart or table you’re using by clicking on the “© License” link to the below left of the title.
• This will take you to a Creative Commons licensing page, which details the license that applies to that particular content. Note: different pieces of content have different licenses, so it’s important to check this every time.
• Copy the text that appears in brackets after the full license description (called the “slug”) – this is what you need to include in your credit. The slug will be something like “CC BY 4.0”.
• If you’re using a chart, create a credit saying “Figure.NZ / [License]”, replacing [License] with the slug.
• If you’re using a table – for example, to make your own chart from the data – create a credit saying “Sourced from [Provider name] via Figure.NZ under [License]”, replacing [Provider name] with the provider info (this appears just below the table title), and [License] with the slug.
• Make the text that says “Figure.NZ” a link to the original chart on Figure.NZ, so readers can explore further if they’re interested.
• Maps cannot be re-used due to licensing issues.

Misuse of our content

Figure.NZ makes information available to all New Zealanders, without restrictions. Thousands of our charts and tables are seen every day in newspapers, forums, and on web sites other than our own. We don’t require anyone to discuss their use with us or ask our permission. Making data freely available is what we do.

Occasionally, this means you may see our charts used in some unusual places, or to justify controversial or poorly-considered points of view. While we monitor how our data is used, we don’t restrict it unless it is being used unlawfully.

We’re aware that fringe groups occasionally use our charts out of context, or to justify positions that are not always supported by the data made available by the chart. We don’t police this, and you don’t need to report these instances to us. We aim to counter misinformation by continuing to publish truthful, verified data.

Figure.NZ datasets are historical and even our latest updates may not reflect the most up-to-date information. For general information about COVID-19, visit covid19.govt.nz. For access to provisional datasets about the spread of COVID-19 in New Zealand, visit the Ministry of Health.

Updates to data

Figure.NZ publishes the most up-to-date information available. We almost always do this by replacing older versions with newer versions at the same URL, because this makes it easier to use Figure.NZ as a reference.

This also means if you link directly to a specific content on Figure.NZ in a publication or printed work, you should expect that content to be periodically updated to include new information. We put substantial effort into doing this without breaking links to the original content, but you should anticipate that the resources you link to may change over time.

On very rare occasions, we may remove content you have previously linked to, either because it has since been found to be inaccurate, or the nature of the material and its collection procedure has changed so dramatically it no longer shows the same information. In those cases, we try hard to provide links to related content as an alternative.

About our data

The data we have is defined as follows.

• Public and aggregate. To protect individual privacy, we don’t publish any personal or unit record data.
• Relevant for New Zealand. Most of our data is about New Zealand, but we do publish some public international data so we can compare New Zealand with other countries.
• Collected by others. We don’t do any primary data collection. We rely on the good work of lots of providers.
• Of varying quality. Hundreds of organisations in New Zealand collect data that’s relevant for us to use. Some of these organisations have robust and official statistical methods (like Statistics New Zealand), and others are simply collecting data from their customers, or as a by-product of the service they provide. All of our content is clearly labelled with the name of the provider, where the data came from, and the metadata included in it.
• On lots of topics. We care about all topics relevant for New Zealand. What we have is limited to what we’ve had the resources to publish so far, but we add more every day. You can see what kinds of data we have by looking at our topics or providers pages.

Data treatment

All data we publish is checked separately by two members of our data team, and we maintain a complete audit trail down to the individual cell in everything we publish.

Once we’ve sourced a dataset we want to publish, we follow the process below.

Import and extract

1. Check if the data file needs any modifications. This can include things like deleting duplicate data points, or combining multiple data sheets into one.
2. Import the dataset file to Grace.
3. Add the dataset metadata. This is the set of definitions and methodology notes (how and why the data was collected) that come from the data provider.
4. Do extractions. This is us using Grace to transform the original data format into a machine-readable and human-friendly CSV file.
5. If required: add to enumerations. Enumerations are standard lists of concepts or geographical areas that we use consistent words for across disparate datasets. Some examples of enumerations are country, region, industry, and occupation.
6. Refine dataset metadata. We review the metadata, adding detail that makes it easier to understand.

Audit extraction and dataset metadata

1. Audit the dataset metadata. We do this by getting another data officer to sense-check and proofread the metadata (including notes and definitions) that will appear with our charts and tables.
2. Audit tables and add tags. This is when we make sure our standardised CSV file reflects the original data accurately. We check we haven’t missed any data points by mistake, and that the units are correct (for example, NZD, %, hectares, etc). We add tags so people can find the tables easily through the figure.nz search or by browsing suggested topics.
3. Publish tables. This is when we’re confident enough in the data to make it available for everyone to see!
4. If required: add Linked Enumeration Values (LEV). LEVs are a kind of metadata we can attach to our tables, to show that the information in the table is somewhat related to a concept. For example, this what we use to tell our website that marriage and funeral data may be of interest to florists.

Make charts

Audit

1. Audit charts. We do this by getting another data officer to check that the charts are showing the information accurately, that the title is clear, and that the chart type we’ve used (like bar, column, or line) is the most appropriate option.
2. Publish charts. This is when the charts become searchable on figure.nz 🎉
3. If required: delete any old content. If a new chart is a better source of information for data we already had, we may get rid of the old content.

We’re still only human 🤔, so if you spot anything we should check, please send us an email at data@figure.nz.

Our process is designed to preserve as much metadata as possible, both to allow future calculations based on the data, and also because it’s hard to know in advance which metadata will be significant to people.

All of our data publishing is supported by the software we’ve designed and built for this purpose. If you’re interested in what happens behind the scenes, you can read about our technology stack in our frequently asked questions section.

Finding data

We’re continuously working to make it easier for you to find the content you need 🕵🏾‍.

Getting good search results from large volumes of relatively similar data is a hard problem, and we’re still working on that. If you’re struggling to find something, we’d like to know. If we don’t have it yet, we can probably tell you where to find it, or it could be that our search is letting you down.

Either way, send us an email at data@figure.nz or contact us on Twitter or Facebook and we’ll do our best to help.

Publish your data

We’ve developed the software, processes and team required to take data in different formats and turn it into standardised machine-readable form, before publishing it in a variety of consistent formats that make it easy for everyone to use.

We provide commercial data publishing services to those that want to make their data public and easy to use. All the data we process is free for everyone to use and take from figure.nz.

Being a charity is critical to what we’re doing, because it means we don’t have competing priorities. We’re here to advance New Zealand and we have a very clear purpose around that.

Here’s what our system looks like.

Services we provide

You can engage us in the following ways.

• To publish specific datasets. These can be your own, or others’, if we’re allowed to use them. You can use us as your external-facing channel for getting your data open and getting it used. Examples of those using us this way include the Treasury, Department of Internal Affairs, and the NZ Defence Force.
• To publish data on a topic. Want to see a range of data on a specific topic published? We can look at public domestic and international providers to publish data for you. Examples of those using us this way include Department of Prime Minister and Cabinet, Auckland Tourism, Events and Economic Development Agency, and InternetNZ.
• To create charts and maps. If you want particular charts and maps that aren’t already on figure.nz, we can make these for you. This may be for a report, blog, online stories, presentations or pitches, especially when you need the added benefit of having our trusted and neutral third party branding. We’ll do our best to make what’s useful for you, but we won’t compromise our standards.

Why use our services

Organisations engage us instead of publishing their own data for the following reasons.

• We make it easy to find. If people can’t find your data, they can’t use it.
• We make it easy to understand. Data that’s presented in lots of different styles is too hard for people to use. We put the data you care about into consistent and usable formats.
• We support your data. Our social media engagement and promotional campaigns are fully backed by an expert team who can answer questions about your data and how to use it.
• You can benefit from our work to promote data use throughout New Zealand: our media relationships, our private-sector partnerships, our public promotional work, and our own front-end tools.
• No security risk. We work only from the data you provide to us, so your internal systems are never exposed. This also removes the cost and complexity of another large IT project, and our auditing process catches any remaining errors.
• We make it fast, cheap and great. Most organisations aren’t experts at making data usable, because they’re focused on delivering their core products and services, not data science.

Best of all, you don’t need to change anything internally to use Figure.NZ’s services. We don’t need access to your internal systems — simply give us a copy of the data, even if it’s in Excel spreadsheets, and we’ll handle the rest.

You’ll not only have your data published, it’ll also be standardised with metadata, compliant with New Zealand’s national standards, and easier for your team to use internally. Our expert data officers can also give you feedback on anything that might help you to improve your data practices.

Fast, cheap and great

Publishing your data is important, but it’s likely your team have other priorities. We know most organisations with data are data providers by accident — they collect data as a by-product of other services, and are unlikely to have in-house data publishing skills. We make it easy and safe for you to publish your data.

All you need to do is give us your data as-is — it can be in Excel spreadsheets, or CSVs, or even a PDF report. We’ll take care of the rest. Sometimes it’s easiest for organisations to start with data that’s already technically public but is hard to find and use — this way there are fewer hurdles to making it open and it’s easier to get comfortable with how we work.

We’ve created a custom software platform, Grace, which is designed to efficiently and accurately take your data from its current formats and turn it into beautiful machine-readable tables. This saves you hours of processing time.

Charts and maps can be easily updated when new data is released. They don’t need to be recreated — we simply add the new data and all the published data updates automatically.

Even better, the processed data can be reused anywhere. You can take the charts and maps we make and share them internally to help your team see patterns and gain insights, which in turn can help with making better decisions. You can save time when you receive Official Information Act requests — simply link the requester to the freely available data you’ve already published on Figure.NZ. You can even proactively promote your available data to cut down the requests coming in the door.

It sounds like there should be a catch. We know when you’re asked to choose from fast, cheap, and good, you can usually only pick two, but we’re a unicorn 🦄. As a charity, we can offer you excellent value, excellent quality and world-leading technical services.

Our approach works

Data published on figure.nz is usable and it gets used.

As part of our data processing we create tables, charts and maps that are specially designed to be both user-friendly and accessible to all New Zealanders. Our data officers can create hundreds of charts in a single day. As part of this process, we create plain-language definitions for the terms your organisation uses, enabling everyday New Zealanders to really understand the data you collect.

Your content is published to our web site and can be shared via social media and with our media partners like Stuff. We’re constantly exploring new ways to get New Zealanders engaged in data, from quizzes and radio segments, to videos and talks.

Some examples of the data we’ve published being used:

• Stuff
• RNZ
• Newsroom
• The Wireless
• The Spinoff
• Te Punaha Matatini innovation blog series
• AI Forum: Shaping a Future New Zealand report

Internal benefits

Publishing your data has benefits for the people in your organisation, as well as the public.

We know that teams who can understand the problems they’re trying to solve through data make better decisions, but it’s hard to do that when you can’t find or make sense of your own figures.

Publishing your data with Figure.NZ brings together the data scattered throughout your organisation, making it much easier for your teams to find. The data is also published in easy-to-understand forms like charts and maps, making it more user-friendly for your less confident data users, encouraging them to use numbers in their thinking. It’s also published in machine-readable, downloadable CSV files, so your more advanced users can quickly dig into it to do deeper analysis without needing to spend time cleaning it up.

Figure.NZ also makes it easier to understand the information. We publish metadata that explains data providers and jargon alongside every chart, map and table on our site, and we’re developing data literacy material designed to help build confidence and competence in data use.

Future-proof

We live in an unpredictable world and it’s vital that information doesn’t get locked into a single system. We can help you future-proof your data, taking it from random bespoke formats and turning it into something that’s easily portable and reusable. Everything we process is transformed into machine-readable form, and is completely available for you to easily take, use, feed back into internal systems, and archive at any time.

What our services cost

We’ve done data publishing projects that range in cost from $1,000 to $100,000.

Cost is driven by how long it takes our team to process your data, which in turn depends more on the state of your datasets than their size — large datasets that are already in a simple CSV file are often faster to process than small ad-hoc spreadsheets. However, we can process all types of dataset. As a very rough indication, a $1,000 project produced about 40 charts, and a $100,000 project produced about 6,000 charts.

Updating datasets when new data is released is faster and cheaper than the initial processing. Our sophisticated internal tools keep track of the changes, and if your data format hasn’t changed since the previous version, a full update will only cost about 15% of the initial processing cost.

It’s hard to predict the price without first spending time looking through a dataset to see what form it takes. Often customers will engage us by setting a maximum project fee and then trust us to process as much as we can, giving regular updates so they feel comfortable. Working this way allows us to publish the most data for the least money, serving both your publishing goals and our charitable mission.

How to engage us

Get in touch with Baruch ter Wal to chat about engaging our services at any time by sending an email to baruch.terwal@figure.nz or calling +64 21 388 420.

We understand that making the decision to publish your data is often best done with others involved, and we’re happy to come and talk with your team about what we can do.