[Esip-documentation] ACDD status
Nan Galbraith via Esip-documentation
esip-documentation at lists.esipfed.org
Mon Dec 1 15:49:41 EST 2014
Hi all -
Source and history are not ACDD attributes, they are both part of CF,
and defined by
the CF docs; I don't think we want to mess with these definitions.
source: The method of production of the original data. If it was
model-generated, source
should name the model and its version, as specifically as could be
useful. If it is
observational, source should characterize it (e.g., "surface
observation" or "radiosonde").
history: Provides an audit trail for modifications to the original data.
Well-behaved generic
netCDF filters will automatically append their name and the parameters
with which they were
invoked to the global history attribute of an input netCDF file. We
recommend that each line
begin with a timestamp indicating the date and time of day that the
program was executed
The software version can be inserted into the history; I like to have
each line in this attribute
include a date, a program name, program version (if available), and a
quick description of the
process that was done and the inputs used, something like:
history = "2014-11-20: do_met_to_OTS v.2014-10-10, convert
stratus1_met_60s.mat to NetCDF
2014-10-20: edit_imet.m, correct time base, despike sst, input
stratus1_met_raw.mat output stratus1_met_60s.mat" ;
My 2 cents -
Nan
On 11/26/14 12:31 PM, Philip Jones - NOAA Affiliate via
Esip-documentation wrote:
> Bob,
>
> For the software_version, I was thinking of processing software
> packages that are provided to users and archives along with the data
> for transparency. I see your point however on complexities where
> comprehensive packages do not exist, or with data that is further
> modified after its initial creation.
>
> I'm still not 100% clear on the guidance for history and source.
> Should 'source' just reference the software or model used to create
> the original data, and 'history' to document only the changes that
> happen after initial creation? Is it appropriate for 'source' to also
> include references to the source/ancillary data?
>
> Phil
>
> On Tue, Nov 25, 2014 at 7:15 PM, Bob Simons - NOAA Federal via
> Esip-documentation <esip-documentation at lists.esipfed.org
> <mailto:esip-documentation at lists.esipfed.org>> wrote:
>
> I like product_version since it is useful, clearly applies to the
> current version of the data, and is a separate attribute (so this
> info doesn't need to be extracted from e.g., history).
>
> I think software_version is trouble.
> * What software is this the version number of?
> * This only works if the data just goes through one software
> program. As soon as there is a second processing step with other
> software, it just becomes confusing or out-of-date. That's what
> 'history' is for. Yes, 'history' is only semi-structured, but it
> can deal with multiple processing steps and can include date,
> software name, software version, and software parameters.
>
>
>
> On 2014-11-25 2:42 PM, Philip Jones - NOAA Affiliate via
> Esip-documentation wrote:
>> All,
>>
>> I have a third agenda topic to add for the December 4th meeting.
>> I'd like to discuss the possibility of adding two new global
>> attributes for the product and product generation software versions.
>>
>> Name: product_version
>> Description: The version identifier of the product based on the
>> algorithm or methodology applied.
>>
>> Name: software_version
>> Description: The version identifier of the software that
>> generated the data.
>>
>> Please send your comments on the proposed attributes before next
>> week's ACDD meeting.
>>
>> Thanks.
>>
>> Phil
>>
>> On Thu, Nov 20, 2014 at 3:39 PM, John Graybeal via
>> Esip-documentation <esip-documentation at lists.esipfed.org
>> <mailto:esip-documentation at lists.esipfed.org>> wrote:
>>
>> hi everyone,
>>
>> With the latest ESIP Documentation meeting, I've updated the
>> specification per the two changes we agreed upon, and I think
>> the ACDD 1.3 document is again down to at most 2 'minor' open
>> issues.
>>
>> We have scheduled an ACDD meeting for 2 weeks from today, Dec
>> 4, to discuss these topics as needed; my hope is that they
>> are resolved via this list before then.
>>
>> (1) Is the existing text describing the publisher (person or
>> other entity "responsible for publishing the data file or
>> product to users, with its current metadata and format")
>> appropriate?
>>
>> (2) Is the standard_name_vocabulary attribute necessary and
>> appropriate, given CF specifies the purpose of the
>> standard_name attribute.
>>
>> I will follow up on each of these separately via email.
>>
>> By the way, if you are looking for all the historical Wiki
>> Discussion page notes, they are at the 'Working' document's
>> Talk page:
>> http://wiki.esipfed.org/index.php/Talk:Attribute_Convention_for_Data_Discovery_1-2_Working
>>
>>
>> I'm sorry that we missed talking through today's issues last
>> week, as originally planned; but today's CF standard_name
>> discussion was important and otherwise might not have
>> happened. So it's all good.
>>
>> John
>>
>>
>>
>>
>> _______________________________________________
>> Esip-documentation mailing list
>> Esip-documentation at lists.esipfed.org
>> <mailto:Esip-documentation at lists.esipfed.org>
>> http://www.lists.esipfed.org/mailman/listinfo/esip-documentation
>>
>>
>>
>>
>> --
>> Philip R. Jones
>> Team ERT/STG
>> Government Contractor
>> National Climatic Data Center, NOAA NESDIS
>> Veach-Baley Federal Building
>> 151 Patton Ave.
>> Asheville, NC 28801-5001 USA
>> Voice: +1 828-271-4472 <tel:%2B1%20828-271-4472> FAX: +1
>> 828-271-4328 <tel:%2B1%20828-271-4328>
>>
>>
>> _______________________________________________
>> Esip-documentation mailing list
>> Esip-documentation at lists.esipfed.org <mailto:Esip-documentation at lists.esipfed.org>
>> http://www.lists.esipfed.org/mailman/listinfo/esip-documentation
>
> --
> Sincerely,
>
> Bob Simons
> IT Specialist
> Environmental Research Division
> NOAA Southwest Fisheries Science Center
> 99 Pacific St, Suite 255A (New!)
> Monterey, CA 93940 (New!)
> Phone: (831)333-9878 <tel:%28831%29333-9878> (New!)
> Fax: (831)648-8440 <tel:%28831%29648-8440>
> Email: bob.simons at noaa.gov <mailto:bob.simons at noaa.gov>
>
> The contents of this message are mine personally and
> do not necessarily reflect any position of the
> Government or the National Oceanic and Atmospheric
> Administration.
> <>< <>< <>< <>< <>< <>< <>< <>< <>< <><
>
>
> _______________________________________________
> Esip-documentation mailing list
> Esip-documentation at lists.esipfed.org
> <mailto:Esip-documentation at lists.esipfed.org>
> http://www.lists.esipfed.org/mailman/listinfo/esip-documentation
>
>
>
>
> --
> Philip R. Jones
> Team ERT/STG
> Government Contractor
> National Climatic Data Center, NOAA NESDIS
> Veach-Baley Federal Building
> 151 Patton Ave.
> Asheville, NC 28801-5001 USA
> Voice: +1 828-271-4472 FAX: +1 828-271-4328
>
>
> _______________________________________________
> Esip-documentation mailing list
> Esip-documentation at lists.esipfed.org
> http://www.lists.esipfed.org/mailman/listinfo/esip-documentation
--
*******************************************************
* Nan Galbraith Information Systems Specialist *
* Upper Ocean Processes Group Mail Stop 29 *
* Woods Hole Oceanographic Institution *
* Woods Hole, MA 02543 (508) 289-2444 *
*******************************************************
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.lists.esipfed.org/pipermail/esip-documentation/attachments/20141201/d628cabc/attachment.html>
More information about the Esip-documentation
mailing list