To make your data discoverable and usable by others, it is essential to document its structure and contents via metadata. Metadata is best stored in a standardized format, such as the Ecological Metadata Language (EML) used by the Environmental Data Initiative (EDI) data repository.

ezEML is a tool that helps you create EML metadata for your data packages. It provides a user-friendly interface for entering metadata and checking it for completeness and correctness. ezEML generates the EML document for you and gives you the means to submit your data package to the EDI data repository.

When you create an EML metadata document in ezEML, for example via New or New from Template in the EML Documents menu, you are asked to enter a document name.

This is the name by which the document is known to ezEML. Think of it as you would a file name (without file extension). Choose a name that will be meaningful to you if you come back to ezEML at a later time. Feel free to use any naming conventions favored by your research team or site.

If the data package is submitted to the EDI data repository, the package will be assigned a Data Package ID by which it will be known to the data repository, but ezEML knows the document by the document name you specify when creating the document in ezEML. The ezEML document name will not appear in the EML metadata. It is distinct from the Title and Data Package ID, both of which are saved in the EML.

ezEML displays colored “badges” that indicate all errors and warnings associated with the various sections and elements of an ezEML data package. These badges are clickable, showing lists of errors and warnings, and the errors and warnings they list are themselves clickable and take you directly to the item that needs to be added or edited, scrolling it into view and highlighting it.

Red badges indicate that errors are present in a particular page or section, yellow badges indicate there are warnings only, and green badges indicate the absence of any errors or warnings. Your goal in editing an ezEML data package should be to enter all required and recommended metadata, making corrections until, at minimum, no red error badges remain. Even better would be to get rid of all yellow warning badges, as well, thereby making all badges green.

This is highly dynamic functionality, so the easiest way to see how it works may be to watch the YouTube video, here.

ezEML facilitates entering the metadata for a data table via Load Data Table from CSV File on the Data Tables page. ezEML gathers all of the metadata it can from the CSV file and enters it. Certain values, such as the data table Description, the Definition of a column, and the Unit of a numerical column, are not present in the CSV file and need to be entered manually. The colored "badges" help you locate items that need to be filled in. Note that ezEML refers to "CSV" -- i.e., "comma-separated" -- files, but it can also load tables delimited by other characters, such as tabs or semicolons.

What if your table has a very large number of columns? In such cases, entering the needed definitions, units, etc., a column at a time will be laborious. ezEML lets you edit all of the column properties at once in a spreadsheet. Click Edit Column Properties for the table, then click Download Column Properties Spreadsheet. This will download a spreadsheet that you can edit in Excel or another spreadsheet program. When you are done, save the spreadsheet and upload it back into ezEML via Upload Column Properties Spreadsheet, and ezEML will make the changes to the table all at once.

As you work, ezEML continually checks your metadata for completeness and correctness as indicated by the colored “badges” next to various items. Click a red or yellow badge to see a list of the relevant errors and warnings, which are themselves clickable, taking you to where the correction is needed. Alternatively, click Check Metadata in the Contents menu to see all errors and warnings in a single list.

To check data tables, click Check Data Tables in the Contents menu. Tables are checked to see if the table’s contents are congruent with the table’s metadata.

Metadata and tables are checked further by the EDI data repository when data packages are submitted to the repository.

To fetch a data package from the EDI repository, click Fetch a Data Package from EDI in the Import/Export menu. You will be asked to select the package you wish to fetch. The data package metadata will be downloaded from the EDI repository and opened in ezEML.

You will have the option then to download the associated data files as well. If you only need to inspect or update the metadata, you can choose not to download the data files, which may be large.

When you have finished entering your metadata and have uploaded all data tables and other data entities, you can submit your entire data package to the EDI data repository. Click Submit/Share Package in the Contents menu, then click Submit Package to EDI. You will be asked to enter identifying information and then click Submit Package to EDI again.

At this point, EDI's data curation team will take over, checking your metadata and data tables for completeness and correctness. If there are any issues, you will be contacted by email. If everything is in order, your data package will be assigned a Data Package ID and published in the EDI data repository.

While EDI's curators are reviewing your package, it is locked against further editing in ezEML. If you need to make changes to the package, contact support@edirepository.org to request that the package be made available to you.

Likewise, if the curators find issues that need to be addressed, they will contact you by email and make the package available to you for editing in ezEML. You can then make the necessary corrections in ezEML and make the package available to the curators again by clicking Make available in the Collaborate page. For more information, see "Submitting Your Package to EDI" in the User Guide.

To update a data package that has already been published in the EDI data repository, fetch the package from the repository, make the desired changes, and then submit the package to the repository again, indicating on the submit package page that the submission is a revision.

The package will be assigned a new version number by the EDI data curation team.

A particular research site or team may find that portions of the metadata they enter are the same for lots of data packages. Examples of such repeated content can include Creators, Contacts, Keywords, Intellectual Rights, Geographic Coverage, Project, etc.

To save time and ensure consistency, ezEML lets you to create and use templates, which are partial EML documents. Anyone can use a template. Only selected users can create and edit templates. To be authorized to create and edit templates, contact support@edirepository.org.

There are two ways to use a template. You can create a new package pre-populated with a template's metadata by using New from Template in the EML Documents menu. Or, you can import selected metadata from a template into an existing package by using the various Import features in the Import/Export menu. The Import features let you import either from a template or from another data package.

For more information, see "Starting from an ezEML Document Template" in the User Guide.

Ordinarily, the ezEML data packages that you've created are visible only to you. It can be useful, however, to set up collaborations with colleagues to enable them to open and edit or review packages you've created.

ezEML lets you establish and manage such collaborations via the Collaborate page, accessible via the menu bar at the top right of the ezEML window. When you have an EML document open, you can invite others to collaborate on that document by clicking Invite a Collaborator on the Collaborate page.

The topic is covered in detail in "Collaborating with Others in ezEML" in the User Guide, or watch the YouTube video, here.

To preview how your data package will appear in the data portal for the EDI repository, click Preview Your Metadata in the EDI Data Portal in the Import/Export menu. The generated preview will be displayed in a new tab in your browser.

The preview shows how the metadata will be displayed in the EDI repository, including the data tables and other data entities you have uploaded. It will, for example, let you see the data tables' metadata in a spreadsheet-like format. It will also render Markdown content, as described in the next FAQ.

The EML standard allows certain metadata elements, such as Abstract and Method Step Description, to include Markdown formatting.

In order to enter Markdown tags in ezEML, you need to enable "Complex Text Element Editing" on the Settings page, accessible via the EML Documents menu. For details on how complex text element editing works, see the associated Help button on the Settings page.

ezEML doesn't render Markdown directly, but you can preview it by using Preview Your Metadata in the EDI Data Portal in the Import/Export menu.

For example, in the Abstract element, you can enter Markdown like this:

\<abstract\>
\<markdown\>
- Hello
- Goodbye
\</markdown\>
\</abstract\>

To enter equations via LaTeX, enable Complex Text Element Editing and enter the LaTeX code. No need to use Markdown. For example:

\<abstract\>
Equation 1: $$VWC = -5.3 \times 10^{-2} + 2.92 \times 10^{-2}K_a - 5.5 \times 10^{-4}K_a^2 + 4.3 \times 10^{-6}K_a^3$$
\</abstract\>

As in the Markdown case, preview the rendering of the LaTeX code by using Preview Your Metadata in the EDI Data Portal in the Import/Export menu.