[tdwg-content] FW: dwc

[Ginzbarg, Steve]

>>>From the Darwin Core Progress page, http://code.google.com/p/darwincore/wiki/DarwinCoreProgress, perhaps you could change the paragraph:

The Documents

The entry level document for the Darwin Core standard can be found at http://rs.tdwg.org/dwc/index.htm. This is where anyone new to the documents should start.

to

The Documents

The entry level document for the Darwin Core standard can be found at http://rs.tdwg.org/dwc/index.htm. This is where anyone new to the documents should start. To go directly to a list of all Darwin Core terms and definitions go to <Darwin Core Terms: A quick reference guide> http://rs.tdwg.org/dwc/terms/.

Steve

-----Original Message-----
From: gtuco.btuco at gmail.com [mailto:gtuco.btuco at gmail.com] On Behalf Of John R. WIECZOREK
Sent: Thursday, August 13, 2009 3:36 PM
To: Ginzbarg, Steve
Subject: Re: [tdwg-content] dwc

Mind posting the response to tdwg-content, where I can then respond again?

Not sure what you mean or suggest by the last sentence "I had a hard
time finding the link on the webpage to all the terms and definitions,
http://rs.tdwg.org/dwc/terms/." Do you mean that it isn't clear that
the Quick Reference Guide is the first place to look for them?
Recommendations?

-----Original Message-----
From: Ginzbarg, Steve 
Sent: Thursday, August 13, 2009 3:23 PM
To: 'tuco at berkeley.edu'
Subject: RE: [tdwg-content] dwc

John,

That's better. Some other possible wordings below.

-----Original Message-----
From: gtuco.btuco at gmail.com [mailto:gtuco.btuco at gmail.com] On Behalf Of John R. WIECZOREK
Sent: Thursday, August 13, 2009 11:37 AM
To: Ginzbarg, Steve
Subject: Re: [tdwg-content] dwc

Thanks for your tenacity and patience, Steve.

I see what you are saying now. For the distances from surface, there
is nothing saying explicitly what the nearest surface actually is. Is
it the surface defined by the elevation or the surface defined by the
depth?

I think this can be resolved by the following change in definition for
minimumDistanceAboveSurfaceInMeters from:

"The lesser distance in a range of distance from the nearest surface
in the vertical direction (positive for above, negative for below), in
meters."

to:

"The lesser distance in a range of distance from a reference surface
in the vertical direction, in meters. Use positive values for
locations above the surface, negative values for locations below. If
depth measures are given, the reference surface is the location given
by the depth, otherwise the reference surface is the location given by
the elevation."

[Steve Ginzbarg] or

"The lesser distance in a range of distance from a reference surface, either on land or underwater, in the vertical direction, in meters. Use positive values for
locations above the surface, negative values for locations below."

or

"The lesser distance in a range of distance from a reference surface, either a land/air or a land/water interface, in the vertical direction, in meters. Use positive values for
locations above the surface, negative values for locations below."

A similar change would apply to the maximumDistanceAboveSurfaceInMeters.

For coordinateUncertaintyInMeters I think we can solve the problem
with the following simple change from:

"The upper limit of the distance (in meters) from the given
decimalLatitude and decimalLongitude describing a circle within which
the whole of the Location is contained. Leave the value empty if the
uncertainty is unknown, cannot be estimated, or is not applicable
(because there are no coordinates). Zero is not a valid value for this
term."

to:

"The horizontal distance (in meters) from the given decimalLatitude
and decimalLongitude describing a circle within which the whole of the
Location is contained. Leave the value empty if the uncertainty is
unknown, cannot be estimated, or is not applicable (because there are
no coordinates). Zero is not a valid value for this term."

[Steve Ginzbarg] That's better. I think "smallest circle" is understood. 

or, more explicitly,

"The horizontal distance (in meters) from the given decimalLatitude and decimalLongitude describing the smallest circle containing the whole of the Location. Leave the value empty if the uncertainty is unknown, cannot be estimated, or is not applicable (because there are no coordinates). Zero is not a valid value for this term."

Would these be satisfactory changes?

[Steve Ginzbarg] Yes. 

I had a hard time finding the link on the webpage to all the terms and definitions, http://rs.tdwg.org/dwc/terms/.

John

On Wed, Aug 12, 2009 at 3:33 PM, Ginzbarg,
Steve<sginzbar at biology.as.ua.edu> wrote:
> Hi John,
>
>> Term Name: minimumDistanceAboveSurfaceInMeters
>>
>> Definition:           The lesser distance in a range of distance from the
>> nearest surface in the vertical direction (positive for above, negative for
>> below), in meters.
>>
>> Comment:          Example: 1.5 meter sediment core from the bottom of a lake
>> (at depth 20m) at 300m elevation; VerbatimElevation: "300m"
>> MinimumElevationInMeters: "300", MaximumElevationInMeters: "300",
>> VerbatimDepth: "20m", MinumumDepthInMeters: "20", MaximumDepthInMeters:
>> "20", DistanceAboveSurfaceInMetersMinimum: "0",
>> DistanceAboveSurfaceInMetersMaximum: "-1.5".
>>
>> Those would be the distances above the surface if the core was raised to the
>> surface of the water. If it was still in place the numbers would be:
>> Example: 1.5 meter sediment core from the bottom of a lake (at depth 20m) at
>> 300m elevation; VerbatimElevation: "300m" MinimumElevationInMeters: "300",
>> MaximumElevationInMeters: "300", VerbatimDepth: "20m", MinumumDepthInMeters:
>> "20", MaximumDepthInMeters: "20", DistanceAboveSurfaceInMetersMinimum:
>> "-21.5", DistanceAboveSurfaceInMetersMaximum: "-20".
>
> Explanation: The nearest surface in the example is the bottom of the
> lake, therefore the example is correct.
>
> ditto maximumDistanceAboveSurfaceInMeters
>
> Given the "to the nearest surface" part of the definition, these terms
> are not redundant; they were defined specifically to address the
> problem of more than one offset from a vertical datum.
>
> [Steve Ginzbarg] It may be clear to the person recording the data which surface is the nearest but how is the person interpreting the data to know which surface was nearest, e.g. the surface of the water or the surface of the bottom of the lake?
>
>> Term Name: coordinateUncertaintyInMeters
>>
>> Definition:           The upper limit of the distance (in meters) from the
>> given decimalLatitude and decimalLongitude describing a circle within which
>> the whole of the Location is contained. Leave the value empty if the
>> uncertainty is unknown, cannot be estimated, or is not applicable (because
>> there are no coordinates). Zero is not a valid value for this term.
>>
>> change "upper limit" to "lower limit"
>
> The coordinateUncertaintyInMeters is the maximum error distance as
> defined in the GBIF Best Practices. It is definitely the upper limit,
> not the lower limit.
>
> [Steve Ginzbarg] Maximum error - we could be off by at most this much; but the shortest radius that describes a circle that contains the whole location. (An infinite radius would describe a circle that contains the location. We're looking for the smallest radius whose circle still does.
>> Steve Ginzbarg
>