Discussion List Archives

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Author roles draft definitions

  • To: Distribution list of the IUCr COMCIFS Core Dictionary Maintenance Group<coredmg@iucr.org>
  • Subject: Author roles draft definitions
  • From: James Hester via coreDMG <coredmg@iucr.org>
  • Date: Fri, 7 Aug 2020 12:10:08 +1000
  • Cc: James Hester <jamesrhester@gmail.com>
  • DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;h=mime-version:reply-to:from:date:message-id:subject:to;bh=XhFaghwngAuZdSumRKFDxnSysfbA0NDHa3y6n9PPnCo=;b=KY5o5MwbDyRnj/SHVpdLts3+nY74Jkj45IlJPtpfzHmZ+UiYQ7hQZFl/Ue54hD3iGLrjQY/GPxOcWxfA5wV5eOyuZhFrVt9WdDHUdZq28M/M38+T8AUKxaSzhlt5IVLdKOKp7h4X48MWckOLQgfzXTf5CezXvGhw8XW34EQ73xzsFyyqVVkBZXWK+wT7tyQjDA8zo3loygnhjF+xNuyIfHCkG1yeS42u6jTuCPU4JYQ12ww3FjkuAerD1lCN39nPvcU/JorxMLZFq55GT7l5Ais/CHbGi7mZyZXT7kSv52SR0F21KDshQ53iavQmWpmvrlG4AF61xWKdQ0OcpzZwHg==
Dear Core DMG,

Please see the draft definitions for author roles provided below, developed in consultation with the CCDC and Chester. Please advise if you feel any roles are missing. The roles are listed at the very end of the definitions, the rest is boilerplate for setting up a new category.

Note that we have explicitly decided not to adopt the CREDIT taxonomy, as that did not capture the way crystallographic experiments are conducted with sufficient granularity. The option remains open for us to include a separate category where "CREDIT" roles are assigned to authors.

An important decision that is encoded in the definitions below is that the "primary" author identifier is found in the audit_author loop rather than e.g. publ_author. This expands the role of audit_author authors to cover anything related to the production of the data, whereas you could argue that this category was originally intended to cover "just" the author of the data block. If you expect this subtle in interpretation to cause problems, please speak up.

James (Acting chair)
# Draft definitions for author roles, for discussion

_definition.id                          AUDIT_AUTHOR_ROLE
_definition.scope                       Category
_definition.class                       Loop
_definition.update                      2020-08-06
     The CATEGORY of data items used to describe the role that
     authors took in the production of the dataset.
_name.category_id                       AUDIT
_name.object_id                         AUDIT_AUTHOR_ROLE
_category.key_id                        '_audit_author_role.id'



_definition.id                          '_audit_author_role.id'
     Unique identifier for the author for whom a role is identified.
     This may be repeated where an author took on multiple roles.
_name.category_id                       audit_author_role
_name.object_id                         id
_name.linked_item_id                    '_audit_author.id'
_type.purpose                           Encode
_type.source                            Recorded
_type.container                         Single
_type.contents                          Code

_definition.id                          '_audit_author_role.role'
     The role taken by the author identified by _audit_author_role.id,
     drawn from a predefined list.
_name.category_id                       audit_author_role
_name.object_id                         role
_type.purpose                           State
_type.source                            Assigned
_type.container                         Single
_type.contents                          Text
        design     'conceived and/or designed the experiment'
        synthesis  'synthesised the samples'
        preparation 'prepared the samples for measurement, e.g. crystallised or recrystallised the sample'
        characterisation 'performed non-crystallographic measurements on the samples'
        measurement 'collected and/or reduced diffraction data'
        analysis  'worked on the structural model'
        software  'developed bespoke software for specialised data processing and/or analysis'
        submission 'prepared the final CIF file'
T +61 (02) 9717 9907
F +61 (02) 9717 3145
M +61 (04) 0249 4148
coreDMG mailing list

[Send comment to list secretary]
[Reply to list (subscribers only)]