Verifying HXL tags and attributes are sorted correctly

66 views
Skip to first unread message

Carol Kraemer

unread,
May 9, 2019, 2:51:49 PM5/9/19
to Humanitarian Exchange Language (HXL)
Hello HXLers!

I am new to HXL tags and have been reviewing the HXL standard documentation, HDX tools, and this forum. There may not be definitive answers for my questions but I wanted to check in with you all in the hopes of finding out one way or another. :)

Ultimately, I'm looking for a list of all tags and their possible attribute combinations that would be considered a standard to be used in a project(s) I am supporting. I'd like to incorporate that list into the solution we are working on to guide users with data sheets better when trying to join those sheets with geometry (based on COD admin boundaries and have HXL headers). 

My questions:

  • I noticed something when reviewing Gerald's code snippets. He mentions a bit that involves sorting the attributes into alphabetical order (See: Split. Use CsvHuman::Tag.split @ https://github.com/csvreader/csvhuman). That made me wonder if having multiple tag attributes in alphabetical order is part of the HXL standard. If so, I have also been reviewing the HXL Tag Assist | HDX Tools page that has examples and there are some that do not follow this (See: Migrant Deaths by month). Is it a HXL tag standard that in cases where there are multiple attributes for a tag that they be in alphabetical order or follow some other type of heirarchy?

  • Are there others, like myself, requiring these comprehensive HXL tag/attributes lists for their projects and would they be willing to share their experiences with me?

  • I noticed that HXL 1.1 was announced in 2017. When is 1.2 expected?

Thank you in advance!
-Carol

Gerald Bauer

unread,
May 10, 2019, 10:53:23 AM5/10/19
to hxlpr...@googlegroups.com
Hello Carol,

Thanks for referencing my humble tool / quick reference.

I'm just a random guy (nobody) and not in any way part of the
"official" team and, thus, for definite answer you should consult the
official sources (or spokespersons).

As far as I can tell v1.2 is kind of changing for the worse by no
longer supporting simple language tags and adding namespaces and
including other "breaking" changes complicating the original simple
tags and attributes.

Have a great weekend. Cheers. Prost.


PS: My humble opinion about tag / attribute order - I would follow the
xml example that the order doesn't / shouldn't matter. If you want /
need a definite order, you can sort from a to z, for example.

David Megginson

unread,
May 13, 2019, 3:25:15 AM5/13/19
to Humanitarian Exchange Language (HXL)
Hi, Carol, and glad that you're interested in HXL.

Most of the time, the order of attributes does not matter. The one exception is the JSON "list of objects" encoding, where we require that the attributes be in alphabetical order with no space, to guarantee key consistency, e.g.

[
    {
        "#adm1": "Coast region",
        "#affected+idps+m": 100,
        "#affected+f+idps": 200
    },
    {
        "#adm1": "Plains region",
        "#affected+idps+m": 200,
        "#affected+f+idps": 300
    }
]

When you're using HXL in a spreadsheet, it doesn't matter.

There is a machine-readable list of the pre-defined core HXL hashtags and attributes here:

https://data.humdata.org/dataset/hxl-core-schemas

It's important to note, however, that people can create additional hashtags and attributes. There's more information here:

http://hxlstandard.org/standard/1_1final/tagging/#hashtags.extensions

Good luck with your project, and please feel free to post any future questions.


Cheers, David


From: hxlpr...@googlegroups.com <hxlpr...@googlegroups.com> on behalf of Carol Kraemer <cakr...@gmail.com>
Sent: May 9, 2019 2:51:49 PM
To: Humanitarian Exchange Language (HXL)
Subject: [hxlproject] Verifying HXL tags and attributes are sorted correctly
 
--
You received this message because you are subscribed to the Google Groups "Humanitarian Exchange Language (HXL)" group.
To unsubscribe from this group and stop receiving emails from it, send an email to hxlproject+...@googlegroups.com.
To view this discussion on the web, visit https://groups.google.com/d/msgid/hxlproject/e57da527-2077-4702-94d8-bf1acf4efcf1%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Carol Kraemer

unread,
May 13, 2019, 8:31:22 AM5/13/19
to Humanitarian Exchange Language (HXL)
Thank you David and Gerald for your responses! Both are helpful. I'll be sure to review the documentation further.

I find myself even more curious about version 1.2. How is this changing from 1.1? If I understand Gerald's response correctly, the changes are going to be significant?

-Carol
To unsubscribe from this group and stop receiving emails from it, send an email to hxlpr...@googlegroups.com.

David Megginson

unread,
May 14, 2019, 3:37:10 AM5/14/19
to HXL public mailing list
We don't have a fixed date for 1.2 — our first focus is improving 1.1 adoption, before we add anything more to the standard.

If/when there is a HXL 1.2 release, we're not planning any major changes. To date, the working group has been discussing some additional attributes to provide hints for software (data types, in-cell lists of values, cumulative vs non-cumulative values), more attributes to identify affected groups (eg +disabled, +hosts), flagging potentially-sensitive data, and best practices for indicator-based survey data. All of these would be optional extras, so if HXL 1.1 still met all your needs, there would be no need to upgrade.


Cheers, David

To unsubscribe from this group and stop receiving emails from it, send an email to hxlproject+...@googlegroups.com.
To view this discussion on the web, visit https://groups.google.com/d/msgid/hxlproject/50857dc4-3ce5-427a-bbb7-36d9be180162%40googlegroups.com.

Paola Di Maio

unread,
Dec 12, 2020, 12:42:58 AM12/12/20
to hxlpr...@googlegroups.com

Paola Di Maio

unread,
Dec 12, 2020, 12:45:20 AM12/12/20
to hxlpr...@googlegroups.com
Hope everyone is well
sorry blank email fired earlier

has anyone used HXL during Covid or other pandemic related projects?
also, just found a typo
This site is the home of the Humanitarian Exchange Language initiative during it's initial developmen  



Virus-free. www.avast.com

Virus-free. www.avast.com

Chad Hendrix

unread,
Dec 14, 2020, 3:27:16 AM12/14/20
to hxlpr...@googlegroups.com

Hi Paola,

 

That website is from the very early days of HXL, and I had completely forgotten about it. I’ve edited the page to redirect to the current home of HXL: https://hxlstandard.org.

 

As for covid applications of HXL, all of the data pipeline to feed the COVID-19 Data Explorer is based on HXL. There are probably others implementations that I don’t know about.

 

Thanks,

cj

 

From: hxlpr...@googlegroups.com <hxlpr...@googlegroups.com> On Behalf Of Paola Di Maio
Sent: Saturday, 12 December, 2020 6:45 AM
To: hxlpr...@googlegroups.com
Subject: Re: [hxlproject] Verifying HXL tags and attributes are sorted correctly

 

Hope everyone is well

sorry blank email fired earlier

 

has anyone used HXL during Covid or other pandemic related projects?

also, just found a typo

This site is the home of the Humanitarian Exchange Language initiative during it's initial developmen  

 

 

 

Image removed by sender.

Virus-free. www.avast.com

 

Image removed by sender.

Virus-free. www.avast.com

--
You received this message because you are subscribed to the Google Groups "Humanitarian Exchange Language (HXL)" group.
To unsubscribe from this group and stop receiving emails from it, send an email to hxlproject+...@googlegroups.com.

Paola Di Maio

unread,
Dec 14, 2020, 4:01:07 AM12/14/20
to hxlpr...@googlegroups.com
Thank you Chad, neat updates
(changed the subject line)

I cannot see at a quick glance which are the data sources for the covid data and where is/are the source spreadsheets
for the data in the docs and referenced in the map

(sorry have limited eyesight at the moment) I wonde if they are obvious and I am just not seeing them
or if they are not so obvious

thanks
PDM


Reply all
Reply to author
Forward
0 new messages