.. include:: vocabularies/replacements.rst

.. _dci:creator:

Creator (M, 1-n)
===========

``datacite:creator``

The authors of the research output in priority order. May be corporate/institutional or personal creators.

.. _datacite:creator_creatorName:

Property creator (M, 1-n)
----------------

A single creator.

Subproperty creatorName (M, 1)
~~~~~~~~~~~~~~~~

The name of the author. 

*Allowed values, other constraints:*

* Personal names:

  * The format should be: family, given. When in doubt, give the name as it appears, and do not invert.
  * Omit titles (like “Dr”).
 
* Organizational names:

  * In the case of an organization name which clearly includes an organizational hierarchy, list the parts of the hierarchy from largest to smallest, separated by full stops.
  * If it is not clear whether there is a hierarchy, or unclear which is the larger or smaller portion of the body, give the name as it appears in the resource. Only encode organisations in this element to indicate corporate authorship, not to indicate the affiliation of an individual. 
* Non-roman names may be transliterated according to the `ALA-LC <http://www.loc.gov/catdir/cpso/roman.html>`_ schemas. 
* The inclusion of personal and corporate name headings from authority lists constructed according to local or national thesaurus files is optional.

.. The name of the author.
.. Use inverted name, so the syntax will be the following: “surname”, “initials” (“first name”) “prefix”.

Attribute xml:lang (O, 0-1)
^^^^^^^^^^^^^^^^^

The language in which the name is given.

Attribute nameType (R, 0-1)
^^^^^^^^^^^^^^^^^

The type of name denotes whether the creator is corporate/institutional or personal.

.. include:: vocabularies/nametype.rst

.. _datacite:creator_givenName:

Subproperty givenName (R, 0-1)
~~~~~~~~~~~~~~~~

The personal or first name of the author.

.. _datacite:creator_familyName:

Subproperty familyName (R, 0-1)
~~~~~~~~~~~~~~~~

The surname or last name of the author.

.. _datacite:creator_nameIdentifier:

Subproperty nameIdentifier (R, 0-n)
~~~~~~~~~~~~~~~~

Uniquely identifies an individual or legal entity, according to various schemes.

.. _datacite:creator_nameIdentifier_nameIdentifierScheme:

Attribute nameIdentifierScheme (R, 0-1)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The name of the name identifier scheme.
Uniquely identifies an individual or legal entity, according to various schemes.
The format is dependent upon scheme.

*Examplary values:*

* ``CrossrefFunder`` - |CrossrefFunder|
* ``GRID`` - |GRID|
* ``ISIL`` - |ISIL|
* ``ISNI`` - |ISNI|
* ``ORCID`` - |ORCID|
* ``OrgRef`` - |OrgRef|
* ``ResearcherID`` - |ResearcherID|
* ``ROR`` - |ROR|
* ``VIAF`` - |VIAF|
* national researcher/organisation ID authoritative systems (like the Portuguese CIÊNCIAVITAE or the Dutch Digital Author Identifier (DAI))

.. _datacite:creator_nameIdentifier_schemeURI:

Attribute schemeURI (O, 0-1)
^^^^^^^^^^^^^^^^^^^

The URI of the name identifier scheme.

.. _datacite:creator_affiliation:

Subproperty affiliation (O, 0-n)
~~~~~~~~~~~~~~~~

The organizational or institutional affiliation of the creator.

Attribute affiliationIdentifier (O, 0-n)
^^^^^^^^^^^^^^^^^^^

Unique identifier of the organizational affiliation of the creator.

Attribute affiliationIdentifierScheme (MA, 0-1)
^^^^^^^^^^^^^^^^^^^

Name of the affiliation identifier schema. Affiliation identifiers should always be accompanied by their respective schemes.

Attribute schemeURI (O, 0-1)
^^^^^^^^^^^^^^^^^^^

URI of the affiliation identifier schema.

Examples
-------

With initials:

.. code-block:: xml

  <datacite:creator>
     <datacite:creatorName>Cassirer, E.A.</datacite:creatorName>
     <datacite:nameIdentifier nameIdentifierScheme="ISNI" schemeURI="http://isni.org">
        000000012146438X</datacite:nameIdentifier>
  </datacite:creator>

With predicates like de, van etc.:

.. code-block:: xml

  <datacite:creator>
     <datacite:creatorName>Smit, J.H. (John Hubert) de</creatorName>
  </datacite:creator>

With both initials and first name:

.. code-block:: xml

  <datacite:creator>
     <datacite:creatorName>Janssen, J. (John)</datacite:creatorName>
  </datacite:creator>

With generational suffixes (Jr., Sr., etc.):

.. code-block:: xml

  <datacite:creator>
     <datacite:creatorName>Smit Jr., J.H. (John) de</datacite:creatorName>
  </datacite:creator>

When the creator is an organization/institution:

.. code-block:: xml

  <datacite:creator>
     <datacite:creatorName>Utrecht University. Department of Computer Sciences</datacite:creatorName>
     <datacite:nameIdentifier nameIdentifierScheme="ROR" schemeURI="https://ror.org">
        04pp8hn57</datacite:nameIdentifier>
  </datacite:creator>

With affiliation:

.. code-block:: xml

   <datacite:creator>
      <datacite:creatorName>Príncipe, P.M.</datacite:creatorName>
      <datacite:nameIdentifier nameIdentifierScheme="ORCID" schemeURI="http://orcid.org">
         0000-0002-8588-4196</datacite:nameIdentifier>
      <datacite:nameIdentifier nameIdentifierScheme="CIÊNCIAVITAE" schemeURI="https://cienciavitae.pt">
         C915-48B2-6C87</datacite:nameIdentifier>
      <datacite:affiliation affiliationIdentifier="150887294" affiliationIdentifierScheme="VIAF" schemeURI="https://viaf.org">
         Universidade do Minho</datacite:affiliation>
   </datacite:creator>

Context
-------

**Do Not Confuse With**

* :ref:`dci:contributor` (In cases of lesser responsibility, other than authorship, use ``datacite:contributor``).
* :ref:`dci:publisher`

**DataCite v4.3 Differentiation**

* OpenAIRE recommends including name identifiers if available.
* OpenAIRE allows for more idendifier types than DataCite.

**OpenAIRE Data Guidelines v2 Differentiation**