Manging truth data

Zoltar supports uploading ground truth data for each project that desires automatic scoring. This data is specified as a CSV file as documented in Truth data format, and each project is responsible for generating the CSV file for their particular set of time zeros, units and targets. You can tell whether truth has been uploaded to a project by looking at the Truth Data row in the Project details table section of the project detail page. It will either be a link with the truth data file name (which means truth is present) and the number of rows in parentheses, or a "Browse..." button next to a green "Upload" button with the text (No truth data) to its right otherwise. Clicking on the link takes you to the Truth detail page documented in Truth detail page below.

Here's a screen shot showing a project where truth has been uploaded (circled in red):

Truth uploaded

And here's just the truth row when no data has been uploaded:

Truth not uploaded

Following operations on truth data that you can do from within Zoltar.

View truth details

Clicking on the truth link above takes you to the truth details page:

Truth detail page

Here you see a small information table at the top showing the project and truth data filename, followed by a preview of the truth data. At the bottom is a "Download CSV" button that you can click to get the data back as a CSV file.

Upload truth

Follow these steps to upload a truth CSV file:

  1. Go to the project detail page of the project of interest.
  2. Click the "Browse..." button in the Project details table's Truth Data row.
  3. In the dialog that appears, select a truth data CSV file in Zoltar's Truth data format.
  4. Click the green upload button.
  5. If the file is OK then you will be taken to an upload file job detail page that shows the status of your upload, with the message "Queued the truth file for uploading.", where is your file's name. See Check an upload's status below for this page's details.
  6. Once the upload is successful (you can refresh the upload file job page to check) then you will the file name as a link as described above.
  7. If there was a problem uploading then you will see the upload's status as FAILED. The Failure section will provide some information to help debug the problem.

Download truth

Here are the steps to download a project's truth data as a CSV file in Zoltar's Truth data format:

  1. Go to the project detail page of the project of interest.
  2. Click the truth link above go to the Truth detail page page.
  3. Click the 1. Click the "Download CSV" button and save the file.

Delete truth

To delete a project's truth data:

  1. Go to the project detail page of the project of interest.
  2. Click the truth link above go to the Truth detail page page.
  3. Click the red trash can button at the top of the page.
  4. Click "Delete" in the confirmation dialog that appears. Note that this cannot be undone!