[LTER-im] Fwd: New informational check released for EDI data

Thu Jul 12 18:05:01 PDT 2018

Hi Eda,

I am glad you asked the list so everyone can read the answer, especially
our new site IMs.

The *attributeName* should match the column headers in the dataTable, and
be useful as a variable name.
The *attributeLabel* is for humans to read and does not need to be useful
as a variable name.

For example,

attributeName: temp
attributeLabel: Air Temperature

reference:
https://environmentaldatainitiative.files.wordpress.com/2017/11/emlbestpractices-v3.pdf
page 31
quoted below, where I have substituted [] for <> because the angle brackets
confuse email.

*[attributeName]* is typically the name of a field in a data table. This is
often short and/or
cryptic. It is recommended that attributeNames be suitable for use as a
variable, e.g.,
composed of ASCII characters, and that the [attributeName]s match the
column headers
of a CSV or other text table.

*[attributeLabel]* (optional): is used to provide a less ambiguous or less
cryptic
alternative identification than what is provided in [attributeName].
[attributeLabel] is
likely to be used as a column or row header in an HTML display

So it seems you have been using them the other way around. I hope it is
efficient to re-code your EML generation so you do not have a lot of
re-entry to do. Lucky for the new site IMs they will see your question and
be saved that extra work.

Glad to hear from you,
Gastil

On Thu, Jul 12, 2018 at 5:45 PM, Eda C. Melendez-Colom <edacorreo at yahoo.com>
wrote:

> Hi Margaret,
>
> Just one question: should the header row entries in the data table
> coincide with the attributes' names or the attributes' labels in the
> metadata?
>
> I always make sure that the lables in the data columns coincide with the
> labels specified in the metadata but the Name of the Variable in the
> metadata  is usually more descriptive and longer.
>
> EDA
>
> Sent from Yahoo Mail on Android
> <https://go.onelink.me/107872968?pid=InProduct&c=Global_Internal_YGrowth_AndroidEmailSig__AndroidUsers&af_wl=ym&af_sub1=Internal&af_sub2=Global_YGrowth&af_sub3=EmailSignature>
>
> On Thu, Jul 12, 2018 at 12:25 PM, Margaret O'Brien
> <margaret.obrien at ucsb.edu> wrote:
>
> Margaret O'Brien
> ORCID: 0000-0002-1693-8322
> Information Management
> Marine Science Institute, UCSB
> Santa Barbara, CA 93106
> 805-893-2071 (voice)
> http://environmentaldatainitiative.org
> http://sbc.marinebon.org
> http://sbc.lternet.edu
>
>
>
>
> ---------- Forwarded message ---------
> From: *EDI* <info at environmentaldatainitiative.org>
> Date: Thu, Jul 12, 2018 at 9:24 AM
> Subject: New informational check released for EDI data portal
> To: <margaret.obrien at ucsb.edu>
>
>
> The EDI data portal has added a new informational check to the suite of
> data congruence checks it runs on every data package submitted.
> The EDI data portal has added a new informational check to the suite of
> data congruence checks it runs on every data package submitted.
> View this email in your browser
> <https://mailchi.mp/c8c48583b767/new-informational-check-released-for-edi-data-portal?e=99cddc3b2b>
> Hello all -
> The EDI data portal has added a new informational check to the suite of
> data congruence checks it runs on every data package submitted. This check
> is information only and the community felt it was valuable, so we are
> releasing it outside the regular twice-yearly schedule. A brief description
> of the new check is below; for more information contact info@
> environmentaldatainitiative.org.
>
>   About the check: Compare dataTable header row to attribute names
>
> Some programs (e.g., R, matlab) are able read in the first row (header
> row) of a data table and convert the names found there to variables in
> code. EML metadata contains additional information about the attribute
> (table column) that is often not in the table header. EML Best Practices
> state that the header row of a table should match the attributeNames in
> metadata - this check displays header row names of the data table and the
> attribute names provided in the EML metadata to facilitate a visual
> comparison of the two sets of names.
>
> This check displays the header row alongside attribute names for the user
> to compare their content visually. The check does not attempt to ascertain
> if the header and attributeNames match because table headers may be
> composed of multiple lines, and the matching line cannot be identified.
>
> Checks returning warn or errors are released twice a year. A quorum of
> users approved releasing checks that are strictly informative as soon as
> they become available because informational checks do not affect report
> results, but may be of use to data managers.
> To be released: 2018 July 11
>
>    - headerRowAttributeNames:
>       - Justification: Good practice.
>          - Type: congruence
>          - Action: Header row is displayed alongside attribute names
>          Compare the content of the data header row to the content of EML
>          attributeName
>          - Expectation: No expectation, information only
>          - Returns: info
>
>
> <https://environmentaldatainitiative.us14.list-manage.com/track/click?u=c258a774cbd4d34290410d1ea&id=eab085fa04&e=99cddc3b2b>
>
> <https://environmentaldatainitiative.us14.list-manage.com/track/click?u=c258a774cbd4d34290410d1ea&id=24b0c412f2&e=99cddc3b2b>
>
> <https://environmentaldatainitiative.us14.list-manage.com/track/click?u=c258a774cbd4d34290410d1ea&id=8535aa6ba5&e=99cddc3b2b>
> *Copyright © 2018 Environmental Data Initiative, All rights reserved.*
> You were added to the EDI contact list because you expressed interest in
> hearing from us.
>
> *Our mailing address is:*
> Environmental Data Initiative
> Center for Limnology - University of Wisconsin
> 680 North Park Street
> Madison, Wisconsin 53706
>
> Add us to your address book
>
>
> Want to change how you receive these emails?
> You can update your preferences
> <https://environmentaldatainitiative.us14.list-manage.com/profile?u=c258a774cbd4d34290410d1ea&id=da346b264c&e=99cddc3b2b>
> or unsubscribe from this list
> <https://environmentaldatainitiative.us14.list-manage.com/unsubscribe?u=c258a774cbd4d34290410d1ea&id=da346b264c&e=99cddc3b2b&c=60fcbaf37a>
>
> [image: Email Marketing Powered by MailChimp]
> <http://www.mailchimp.com/monkey-rewards/?utm_source=freemium_newsletter&utm_medium=email&utm_campaign=monkey_rewards&aid=c258a774cbd4d34290410d1ea&afl=1>
> _______________________________________________
> Long Term Ecological Research Network
> im mailing list
> im at lternet.edu
>
>
> _______________________________________________
> Long Term Ecological Research Network
> im mailing list
> im at lternet.edu
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.lternet.edu/pipermail/im/attachments/20180712/38310ba2/attachment-0001.html>