Uploading data can be done in two ways: manual via the UI or via the API
Data can be uploaded in two ways:
- using the file explorer
- by drag & dropping the data file into Marple. Make sure to select the right folder before uploading!
After upload, Marple will ask you to select the right data type. We use the file extension to automatically detect the file type, but sometimes you need to manually change it.
Ideally you want to automatically upload the data from your test or simulation. This is easily possible using our API.
Every data set is represented by a data file. That is the way you get data into Marple.
Marple will store these files in a folder structure, just as on your computer. There is a twist however..
Selecting a folder will show you all the files that are in that folder and all subfolders. This might be confusing as it works different compared to what you are used to. Have a play with it and see if you like it!
You can easily create a new folder, rename a folder or remove a folder using the buttons at the bottom.
Note that you can only remove a folder if it is empty.
The different components of the file list:
- Checkbox: allow you to select the specific files or all of them
- Name: file name
- Date uploaded (UTC): time in UTC format specifying when has been uploaded
- Metadata wildcard: additional information related to the data file (location by default)
- Status: information about the the upload state
Order files: by clicking on an column header you can order files
- either by chronological/anti-chronological sequence for digit
- either by alphabetic/anti-alphabetic sequence for character string
By clicking one the 3 dots symbol, you can
- Rename: change the file name
- Move: relocate a file in a different folder (see folder tree on the left panel)
- Delete: remove a file
- Re-import: import again the file to have the latest version of it, correct import bug or change the used plugin
- Download: download the file from Marple
The metadata wildcard allows you to sort your files based on the metadata of your choice. Once selected, the header will behave like the other ones and so will allow you to order your files on that basis. The search bar enables a quick access to specific metadata.
How do you usually organize your files? Using folders right?
We have shown you how you can quickly navigate through your files and folders in (link to section).
Once you start to have a lot of datasets, a folder structure simply does not provide enough dimensions to properly organize your data. This is why Marple allows you to add tags or metadata to your data.
The metadata can be used to find data sets very quickly, simply by selecting the right tags from a dropdown menu. The metadata filters can be found on the right side of the data management view.
How to use metadata filters
- Search everything: this field can be used to do a wild search in your data sets. It will look for file names, all metadata fields, descriptions, ..
- Date uploaded: Quite simple; filter on a date range when the data was uploaded.
- Description: Text based search on the descriptions of a data set
- Test-type (user-defined): This is a metadata field which is defined by the user. In this case it is used to filter based on the different ‘test-types’.
- Version (user-defined): Same as the test-type, just another field defined by the user.
Opening the dropdown of a metadata field shows all the options, as well as the amount of matches it is expected to have.
Primary vs dynamic metadata
Some metadata fields are fixed, every data set needs to have them. These fields are indicated with the blue star. Admins of your workspace can set certain metadata fields to be primary.
Other metadata fields will only show if they are present in the current data selection. This is very useful when there is data from various sources or various test types in Marple.
How to add metadata
When uploading metadata, or editing the metadata you see the following window:
Here you can easily add and change the different metadata values. Some of the metadata fields can be set automatically, if metadata is detected in the data itself.
Once you are happy, just hit ‘SAVE’ and your metadata is ready to be used!
When selecting a file in the data management view, on the bottom left you can find all the details about the data set (file details). Using the ‘Edit metadata’ button you can edit the metadata and follow the same procedure as explained above.