Thread: Re: Location ID change for the DMC's fdsnws-station service in December

Started: 2014-11-17 08:52:39
Last activity: 2014-11-17 17:46:17
Topics: Web Services
Hello Chad,

Will this change affect the location query parameter when forming queries to the fdsnws-station service?

At the moment we would use, for example,

.../query?net=TW&sta=YULB&loc=--&...

following the instructions in the documentation 'Use -- for "Blank" location IDs (ID's containing 2 spaces).'

If blank location ids no longer contain 2 spaces, does this change?

Cheers,
Matthew

Matthew Hoyles
Senior Software Developer | Software Development and Support
ICT Innovation and Services | GEOSCIENCE AUSTRALIA
____________________________________________________________
Phone: +61 2 6249 9890 Fax: +61 2 6249 9999
Email: Matthew.Hoyles<at>ga.gov.au Web: www.ga.gov.auhttp://www.ga.gov.au/
Cnr Jerrabomberra Avenue and Hindmarsh Drive Symonston ACT
GPO Box 378 Canberra ACT 2601 Australia
Applying geoscience to Australia's most important challenges

From: webservices-bounces<at>iris.washington.edu [webservices-bounces<at>iris.washington.edu] On Behalf Of Chad Trabant
Sent: Saturday, 15 November 2014 7:07 AM
To: IRIS Web Services List
Subject: [webservices] Location ID change for the DMC's fdsnws-station service in December


Hello web service users,

Working Group II of the FDSN, the governing body of the SEED and StationXML formats, has decided that empty location IDs in StationXML must be represented by an empty string. This decision means that the StationXML, and implicitly the text output, from the DMC's fdsnws-station service is non-compliant.

To address this, we are planning on changing the output from our fdsnws-station service in the 2nd half of December after the fall AGU. This change may effect end users depending on how you are processing data or if you are managing the metadata on your own.

Currently our service returns empty location IDs as a string containing two spaces. Following the service update, empty location IDs with change as follows:

a) for StationXML: the locationCode attribute of a Channel element will be an empty string. For example: locationCode=" " will become locationCode="".

b) for the channel-level text output: the field for location will be collapsed to nothing. For example, with the delimiting vertical bars: "| |" will become "||".

The latest versions of the DMC's access software support either the two-space or empty string representations synonymously.

The IRIS-WS Java library (and consequently the irisFetch.m MATLAB interface):
http://ds.iris.edu/ds/nodes/dmc/software/downloads/IRIS-WS/

The DMC's Fetch scripts:
https://seiscode.iris.washington.edu/projects/ws-fetch-scripts

We apologize for any inconvenience this change will cause.

regards,
IRIS DMC

Geoscience Australia Disclaimer: This e-mail (and files transmitted with it) is intended only for the person or entity to which it is addressed. If you are not the intended recipient, then you have received this e-mail by mistake and any use, dissemination, forwarding, printing or copying of this e-mail and its file attachments is prohibited. The security of emails transmitted cannot be guaranteed; by forwarding or replying to this email, you acknowledge and accept these risks.
-------------------------------------------------------------------------------------------------------------------------



  • Hi Matthew,

    Nothing will change regarding the location query parameter. Location ID selection will remain exactly was it was before with "--" (two dashes) used to match empty/blank location values.

    Good question and useful to clarify.

    thanks,
    Chad


    On Nov 16, 2014, at 4:52 PM, Matthew.Hoyles<at>ga.gov.au wrote:

    Hello Chad,

    Will this change affect the location query parameter when forming queries to the fdsnws-station service?

    At the moment we would use, for example,

    …/query?net=TW&sta=YULB&loc=--&…

    following the instructions in the documentation ‘Use -- for “Blank” location IDs (ID’s containing 2 spaces).’

    If blank location ids no longer contain 2 spaces, does this change?

    Cheers,
    Matthew

    Matthew Hoyles
    Senior Software Developer | Software Development and Support
    ICT Innovation and Services | GEOSCIENCE AUSTRALIA
    ____________________________________________________________
    Phone: +61 2 6249 9890 Fax: +61 2 6249 9999
    Email: Matthew.Hoyles<at>ga.gov.au <Matthew.Hoyles<at>ga.gov.au> Web: www.ga.gov.au <http://www.ga.gov.au/
    Cnr Jerrabomberra Avenue and Hindmarsh Drive Symonston ACT
    GPO Box 378 Canberra ACT 2601 Australia
    Applying geoscience to Australia’s most important challenges

    From: webservices-bounces<at>iris.washington.edu <webservices-bounces<at>iris.washington.edu> [webservices-bounces<at>iris.washington.edu <webservices-bounces<at>iris.washington.edu>] On Behalf Of Chad Trabant
    Sent: Saturday, 15 November 2014 7:07 AM
    To: IRIS Web Services List
    Subject: [webservices] Location ID change for the DMC's fdsnws-station service in December


    Hello web service users,

    Working Group II of the FDSN, the governing body of the SEED and StationXML formats, has decided that empty location IDs in StationXML must be represented by an empty string. This decision means that the StationXML, and implicitly the text output, from the DMC's fdsnws-station service is non-compliant.

    To address this, we are planning on changing the output from our fdsnws-station service in the 2nd half of December after the fall AGU. This change may effect end users depending on how you are processing data or if you are managing the metadata on your own.

    Currently our service returns empty location IDs as a string containing two spaces. Following the service update, empty location IDs with change as follows:

    a) for StationXML: the locationCode attribute of a Channel element will be an empty string. For example: locationCode=" " will become locationCode="".

    b) for the channel-level text output: the field for location will be collapsed to nothing. For example, with the delimiting vertical bars: "| |" will become "||".

    The latest versions of the DMC's access software support either the two-space or empty string representations synonymously.

    The IRIS-WS Java library (and consequently the irisFetch.m MATLAB interface):
    http://ds.iris.edu/ds/nodes/dmc/software/downloads/IRIS-WS/

    The DMC's Fetch scripts:
    https://seiscode.iris.washington.edu/projects/ws-fetch-scripts

    We apologize for any inconvenience this change will cause.

    regards,
    IRIS DMC
    Geoscience Australia Disclaimer: This e-mail (and files transmitted with it) is intended only for the person or entity to which it is addressed. If you are not the intended recipient, then you have received this e-mail by mistake and any use, dissemination, forwarding, printing or copying of this e-mail and its file attachments is prohibited. The security of emails transmitted cannot be guaranteed; by forwarding or replying to this email, you acknowledge and accept these risks.
    -------------------------------------------------------------------------------------------------------------------------

    _______________________________________________
    webservices mailing list
    webservices<at>iris.washington.edu <webservices<at>iris.washington.edu>
    http://www.iris.washington.edu/mailman/listinfo/webservices

Page built 22:25:07 | v.e7d5ec69