Legacy visualization tools

The Redivis visualization tools are currently deprecated — they are not covered by any support or licensing agreement, and may be removed at a future date.

It is our hope to eventually incorporate these visualizations interfaces within the broader Redivis ecosystem of data management and querying. If you're excited about these tools and want to further support their development, contact us!

1. Log in

If your account has been whitelisted for working with the legacy visualization tools, you will see additional options when you click on your user thumbnail (screenshot below). To upload data, first navigate to the legacy profile.

2. Upload data

Important: Data uploading is currently only supported in recent versions of the Chrome browser

In order to upload data, drag and drop a folder from your computer onto the legacy profile. This folder must contain at least one data file, in csv format, as well as specification file named info.json

The info.json file is a raw text file in the JSON file format. It can be edited in any text editor — e.g., Sublime Text. It can have the following properties:

info.json
// IMPORTANT:
// note that comments (like this) are not allowed in the JSON specification
// and will have to be removed before uploading.
// You can download the example data below to view properly formatted info.json files.
{
"collectionValue": "name of dataset", // alphanumeric and whitespaces characters only
"description" : "your-description", // optional
"attribution": {
"name": "your-name",
"url": "" // this field is required, but may be left as an empty string
},
// (optional) The exact name of the column in your csv file that contains information about the year of the observation
"timepointIndicator": "Year",
// geoData is optional, but required for certain geospatial visualizations
"geoData" : {
// More info at: https://wiki.openstreetmap.org/wiki/Tag:boundary=administrative
// The feature name of the highest admin level, e.g., country name
"name": "Rwanda",
// The top-level boundary. 2 represents a country border
"adminLevel" : 2,
// The interior regions to include in the map. 4 is generally state / provincial
"sublevels" : [4],
// include population density information. This is currently the only option support
"rasters" : ["population_density"],
// A list of road types to include in your visualization, for coverage analysis
// Important: for larger or denser countries, utilizing secondary / tertiary roads may overwhelm the system and cause your query to fail
"roads" : ["motorway", "trunk", "primary", "secondary", "tertiary"],
// Maps to the exact name of the columns in your csv file that contains longitude / latitude
"longitudeIndicator" : "longitude",
"latitudeIndicator" : "latitude"
}
}

Visualizing United States Data

Because of its size, there are some additional challenges when visualizing geospatial data in the US. Redivis implements a few workarounds to provide basic support for this case:

"geoData": {
// one of:
// us_contiguous.json
// us_congress.json
// us_counties.json
// us_states.json
"name": "us_contiguous.json",
"roads": ["us_roads.json"]
// All other geoData options are the same as above
}

Once your data has been uploaded, you will see the dataset added to your profile. You can preview it by clicking on its title.

3. Visualize

To visualize the dataset, click the "Visualize" button on the dataset preview. You will then be provided with a set of visualizations that you can apply to to the dataset.

After selecting a visualization, click the "Next" button at the top of the page. This will take you to the visualizer, where you can then apply additional filters and settings to your visualization to further your analysis.

4. Save your work

To save your visualization, click the name in the top left of the page, optionally renaming the visualization. After this point, the visualization will autosave as you modify it. This visualization will then be available on your legacy profile to come back to later.

5. Publish your visualization

Before exporting your visualization, you must first publish it. To do so, click the "Next" button in the visualizer workflow.

Click the "Next" button to publish

You will then be taken to the publish screen, where you can preview your final visualization. You can select whether you want the visualization to be public or private (you can change this at a later point). When you are ready, click the Publish button.

Prepare your visualization for publication, then click the "Publish" button

6. Export your visualization

All published visualizations will be visible within the "Posts" tab of your profile. To expand the item, hover over it, open the menu, and click "Preview" (alternatively, you can click on it and press the spacebar to open).

View published visualizations on your profile

Once open, you can download the visualization by clicking the "Share" button. This will give you various share and download options — to download an interactive version of the visualization, go to the download tab, and download the visualization as an HTML file. This file can then be opened from any computer via the web browser — without any internet connection required!

Open the share modal to download the visualization