Uploading data

To upload files you have two options:

• Input via the user interface
• Input via the upload API

Via user interface

You can upload data to Metamaze by clicking Menu > Training > Uploads, and then clicking the "+Upload" button in the top right corner:

A new window will appear where you can select the relevant files. You can either drag and drop the files into the window or search for the files via the explorer screen using the 'Browse' button.

Document options

1. Each file is a document

A document will be created for each file in the upload.

2. Each page is a document

A document will be created for each page in the upload.

3. All files are one document

All files will be merged into one document.

Document type and language

You can select the relevant document type and language of the uploaded files in the corresponding dropdown lists. If you do not specify these, the language will be detected automatically, and the document type will be left to specify. The document type and language can be modified later in the document meta data. It is necessary to assign a document type and a language to a document before you can start annotating it.

Via REST API

You can use the Metamaze REST API to upload files to Metamaze. Make sure you only upload files to logically belong together. Often, that means one file is one upload call.

For a tutorial on how to integrate with the REST API, see Rest API (JSON).

The API has a rate limit on how many uploads can be sent per hour depending on your tier license (see Limitations)

Up-to-date API documentation can be found here: https://app.metamaze.eu/docs/index.html. You can also click on the API documentation menu item.

Supported file formats

Currently, the following file formats are supported:

• JPEG
• JPEG 2000
• PNG
• PDF (v1.4 or higher)
• Microsoft Word
• Microsoft Excel
• OpenOffice
• plain text TXT
• TIFF (incl. multipage)
• RTF
• MSG e-mails (including nested attachments)
• EML e-mails (including nested attachments)
• OpenOffice Calc (.ods)

For images, the minimum dimensions should be 250px by 250px. Smaller images will not be processed.

For other file formats, please file a feature request at support@metamaze.eu.

Limitations

The following limitations are enforced:

• maximum file size of 2 GB
• maximum of 200 pages per upload
• maximum 3000 annotations or predictions per document
• maximum of 100 document types in one project
• maximum of 250 entity types per document type
• rate limits for upload per hour depending on the license tier.
• maximum size of emails of 25 MB
• maximum size of attachments in e-mails is 5MB each

Other limitations:

• maximum of 200 pages per document

Upload rate limit