Visualizations

Once your modules have processed data, you’ll want to see the results. Visualizations are how you turn raw analytical outputs into charts, maps, and tables that tell a story. You can customize them, export them as images, or add them to slide decks.

Visualization types

FASTR offers four types of visualizations, each suited to different questions. A chart works well when you’re comparing values across categories - for example, outpatient visits by facility type, or coverage rates across districts. Timeseries visualizations show how a metric changes over time, making them useful for spotting trends or seasonal patterns. Maps display data geographically, which helps when you want to see regional variation at a glance. Tables give you the full numeric detail when you need precise values or want to see multiple dimensions at once.

The type you choose depends on what question you’re answering. If someone asks “how do our districts compare?”, a map or chart makes sense. If they ask “what’s the exact number for District X in March?”, a table is more useful.

Finding and browsing visualizations

Open your project and click Visualizations in the left sidebar. The list shows all visualizations in the project, organized into folders. You can search by name using the search box at the top, which is helpful once a project accumulates dozens of visualizations.

Some visualizations appear with a “default” badge - these are created automatically by modules and can’t be edited directly. If you want to modify a default visualization, opening it will create an editable copy that you can customize and save as your own.

Creating a visualization

Every visualization starts with a metric. Metrics are the analytical outputs produced by your modules - things like “ANC1 coverage rate” or “data completeness score.” When you create a visualization, you’re deciding how to display one of these metrics.

Click Create visualization to start. The first step asks you to select a metric. You can browse by module (useful if you know which analysis produced the output you want) or search by name. Once you’ve selected a metric, you’ll choose how to visualize it.

Presets vs. custom configuration

After selecting a metric, you’ll see a list of presets. Presets are ready-made configurations created by the module authors - they represent common ways to view that particular metric. If a preset matches what you need, select it and you’re done. The visualization opens in the editor, ready to use or fine-tune.

If none of the presets fit, choose Custom. This lets you pick the visualization type (chart, timeseries, map, or table) and configure how to disaggregate the data. Disaggregation means breaking down a single number into more specific views - instead of “total outpatient visits,” you might show visits by month, by facility type, or by district.

Not every disaggregation works with every visualization type. For example, geographic disaggregation makes sense for maps but not for timeseries. The interface shows you which options are available based on the type you’ve chosen.

The visualization editor

Once you’ve created or opened a visualization, you’re in the editor. The left panel contains all the configuration options, organized into three tabs. The right side shows a live preview that updates as you make changes - you can see immediately how your adjustments affect the output.

Data tab

The Data tab controls what information appears in the visualization. This is where you narrow the time range, add or remove disaggregations, or filter to specific values.

Period filters let you focus on a particular time window. If your project contains three years of data but you only want to show the last six months, you’d set that here. Disaggregations let you break down the data - adding a “facility type” disaggregation to a chart would show separate bars for hospitals, health centers, and dispensaries instead of a single total.

If a visualization looks wrong or shows unexpected results, the Data tab is usually the first place to check. A common issue is having too many disaggregations active, which can make the output cluttered or hard to read.

Presentation tab

The Presentation tab adjusts how the visualization looks. For charts, you can change colors, show or hide data labels, and configure axis ranges. For maps, you can adjust the color scale and boundary styling. Tables have options for column widths and number formatting.

These settings don’t change what data is shown - only how it’s displayed. If you want a cleaner look for a presentation, or need to match your organization’s color scheme, this is where you’d make those adjustments.

Text tab

The Text tab adds context to your visualization through three text fields. The caption appears above the visualization as the main title. The sub-caption sits below the caption and is useful for additional context - like the time period covered or the data source. The footnote appears at the bottom and is typically used for methodological notes or data caveats.

Good captions make visualizations self-explanatory. Someone looking at the chart in a slide deck shouldn’t need to read surrounding text to understand what they’re seeing.

Saving and organizing

Click Save when you’re happy with your changes. If you’re creating a new visualization, you’ll be prompted to give it a name and optionally assign it to a folder.

Folders help keep things organized as your project grows. You might create folders by topic (“Coverage indicators,” “Data quality”), by audience (“Ministry presentation,” “Internal review”), or by time period (“Q1 2024 analysis”). To move a visualization to a folder, click the folder icon next to it in the list view.

If you want to create a variation of an existing visualization - say, the same chart but filtered to a different region - open the original and use Save as new from the menu. This creates a copy you can modify without affecting the original.

Exporting

Images

To download a visualization as an image, open it in the editor and click Download. You can choose PNG (good for presentations and documents) or SVG (good for further editing or high-resolution printing). The exported image includes the caption and footnote if you’ve set them.

Data

Sometimes you need the underlying numbers, not just the picture. Click Download and select CSV to get a spreadsheet-friendly file containing the data behind the visualization. This is useful when you need to do additional analysis in Excel or share exact figures with colleagues.

You can create a public link that lets anyone view a visualization without logging in. Click Share, toggle sharing on, and copy the link. This is useful for sharing with stakeholders who don’t have FASTR accounts, or for embedding in reports and emails.

Be thoughtful about what you share publicly. The link gives access to the visualization and its underlying data, so make sure you’re comfortable with that information being visible to anyone with the link.

Common issues

The visualization shows “no data”: Check that your modules have finished running and that the metric has data for the time period and filters you’ve selected. If the project’s data window doesn’t include the dates you’re filtering to, you won’t see anything.

The chart looks cluttered or hard to read: You may have too many disaggregations active. Try removing one or filtering to fewer values. Sometimes a table is a better choice than a chart when you have many categories.

Changes aren’t appearing: Make sure you’ve clicked Save. The preview updates live, but your changes aren’t persisted until you save. If you navigate away without saving, you’ll lose your edits.