Äcdocutils.nodes document q)Åq}q(U nametypesq}q(X#���changes constituting a new snapshotqNX+���preservation and scientific reproducibilityqàX!���importance of the obsolete fieldsqNX1���series identifier resolution to the head revisionq NX���overviewq NX���aggregating download statisticsqNX���mutable member node exampleqNX���usage conventionsq NX%���identifier resolution in dataone apisqNX"���immutability of content in dataoneqNX���summaryqNX!���changes constituting a new seriesqNX���contentsqNuUsubstitution_defsq}qUparse_messagesq]qUcurrent_sourceqNU decorationqNUautofootnote_startqKUnameidsq}q(hU#changes-constituting-a-new-snapshotqhU+preservation-and-scientific-reproducibilityqhU!importance-of-the-obsolete-fieldsqh U1series-identifier-resolution-to-the-head-revisionqh Uoverviewq hUaggregating-download-statisticsq!hUmutable-member-node-exampleq"h Uusage-conventionsq#hU%identifier-resolution-in-dataone-apisq$hU"immutability-of-content-in-dataoneq%hUsummaryq&hU!changes-constituting-a-new-seriesq'hUcontentsq(uUchildrenq)]q*(cdocutils.nodes section q+)Åq,}q-(U rawsourceq.U�Uparentq/hUsourceq0Xo���/var/lib/jenkins/jobs/API_Documentation_trunk/workspace/api-documentation/source/design/ContentImmutability.txtq1Utagnameq2Usectionq3U attributesq4}q5(Udupnamesq6]Uclassesq7]Ubackrefsq8]Uidsq9]q:h%aUnamesq;]q<hauUlineq=KUdocumentq>hh)]q?(cdocutils.nodes title q@)ÅqA}qB(h.X"���Immutability of Content in DataONEqCh/h,h0h1h2UtitleqDh4}qE(h9]h8]h6]h7]h;]UrefidqFUid1qGuh=Kh>hh)]qHcdocutils.nodes Text qIX"���Immutability of Content in DataONEqJÖÅqK}qL(h.hCh/hAubaubcsphinx.addnodes index qM)ÅqN}qO(h.U�h/h,h0h1h2UindexqPh4}qQ(h9]h8]h6]h7]h;]UentriesqR]qS(UsingleqTX���immutabilityUindex-0qUU�NtqVaUinlineqWâuh=Kh>hh)]ubcdocutils.nodes target qX)ÅqY}qZ(h.U�h/h,h0h1h2Utargetq[h4}q\(h9]h8]h6]h7]h;]hFhUuh=Kh>hh)]ubcdocutils.nodes topic q])Åq^}q_(h.U�h/h,h0h1Uexpect_referenced_by_nameq`}h2Utopicqah4}qb(h6]h7]qcUcontentsqdah8]h9]qe(h(hUeh;]qfhauh=Kh>hUexpect_referenced_by_idqg}qhhUhYsh)]qi(h@)Åqj}qk(h.X���Contentsh4}ql(h6]h7]h8]h9]h;]uh/h^h)]qmhIX���ContentsqnÖÅqo}qp(h.U�h/hjubah2hDubcdocutils.nodes bullet_list qq)Åqr}qs(h.U�h/h^h0Nh2Ubullet_listqth4}qu(h6]h7]h8]h9]h;]uh=Nh>hh)]qv(cdocutils.nodes list_item qw)Åqx}qy(h.U�h4}qz(h6]h7]h8]h9]h;]uh/hrh)]q{(cdocutils.nodes paragraph q|)Åq}}q~(h.U�h4}q(h6]h7]h8]h9]h;]uh/hxh)]qÄcdocutils.nodes reference qÅ)ÅqÇ}qÉ(h.U�h4}qÑ(h9]qÖhGah8]h6]h7]h;]Urefidh%uh/h}h)]qÜhIX"���Immutability of Content in DataONEqáÖÅqà}qâ(h.hCh/hÇubah2U referenceqäubah2U paragraphqãubhq)Åqå}qç(h.U�h4}qé(h6]h7]h8]h9]h;]uh/hxh)]qè(hw)Åqê}që(h.U�h4}qí(h6]h7]h8]h9]h;]uh/håh)]qìh|)Åqî}qï(h.U�h4}qñ(h6]h7]h8]h9]h;]uh/hêh)]qóhÅ)Åqò}qô(h.U�h4}qö(h9]qõUid2qúah8]h6]h7]h;]Urefidh uh/hîh)]qùhIX���OverviewqûÖÅqü}q†(h.X���Overviewq°h/hòubah2häubah2hãubah2U list_itemq¢ubhw)Åq£}q§(h.U�h4}q•(h6]h7]h8]h9]h;]uh/håh)]q¶h|)Åqß}q®(h.U�h4}q©(h6]h7]h8]h9]h;]uh/h£h)]q™hÅ)Åq´}q¨(h.U�h4}q≠(h9]qÆUid3qØah8]h6]h7]h;]Urefidhuh/hßh)]q∞hIX#���Changes constituting a new snapshotq±ÖÅq≤}q≥(h.X#���Changes constituting a new snapshotq¥h/h´ubah2häubah2hãubah2h¢ubhw)Åqµ}q∂(h.U�h4}q∑(h6]h7]h8]h9]h;]uh/håh)]q∏h|)Åqπ}q∫(h.U�h4}qª(h6]h7]h8]h9]h;]uh/hµh)]qºhÅ)ÅqΩ}qæ(h.U�h4}qø(h9]q¿Uid4q¡ah8]h6]h7]h;]Urefidh'uh/hπh)]q¬hIX!���Changes constituting a new seriesq√ÖÅqƒ}q≈(h.X!���Changes constituting a new seriesq∆h/hΩubah2häubah2hãubah2h¢ubhw)Åq«}q»(h.U�h4}q…(h6]h7]h8]h9]h;]uh/håh)]q h|)ÅqÀ}qÃ(h.U�h4}qÕ(h6]h7]h8]h9]h;]uh/h«h)]qŒhÅ)Åqœ}q–(h.U�h4}q—(h9]q“Uid5q”ah8]h6]h7]h;]Urefidh#uh/hÀh)]q‘hIX���Usage Conventionsq’ÖÅq÷}q◊(h.X���Usage Conventionsqÿh/hœubah2häubah2hãubah2h¢ubhw)ÅqŸ}q⁄(h.U�h4}q€(h6]h7]h8]h9]h;]uh/håh)]q‹h|)Åq›}qfi(h.U�h4}qfl(h6]h7]h8]h9]h;]uh/hŸh)]q‡hÅ)Åq·}q‚(h.U�h4}q„(h9]q‰Uid6qÂah8]h6]h7]h;]Urefidh!uh/h›h)]qÊhIX���Aggregating Download StatisticsqÁÖÅqË}qÈ(h.X���Aggregating Download StatisticsqÍh/h·ubah2häubah2hãubah2h¢ubhw)ÅqÎ}qÏ(h.U�h4}qÌ(h6]h7]h8]h9]h;]uh/håh)]qÓh|)ÅqÔ}q(h.U�h4}qÒ(h6]h7]h8]h9]h;]uh/hÎh)]qÚhÅ)ÅqÛ}qÙ(h.U�h4}qı(h9]qˆUid7q˜ah8]h6]h7]h;]Urefidh$uh/hÔh)]q¯hIX%���Identifier resolution in DataONE APIsq˘ÖÅq˙}q˚(h.X%���Identifier resolution in DataONE APIsq¸h/hÛubah2häubah2hãubah2h¢ubhw)Åq˝}q˛(h.U�h4}qˇ(h6]h7]h8]h9]h;]uh/håh)]r���h|)År��}r��(h.U�h4}r��(h6]h7]h8]h9]h;]uh/h˝h)]r��hÅ)År��}r��(h.U�h4}r��(h9]r��Uid8r ��ah8]h6]h7]h;]Urefidhuh/j��h)]r ��hIX1���Series Identifier resolution to the head revisionr��ÖÅr��}r ��(h.X1���Series Identifier resolution to the head revisionr��h/j��ubah2häubah2hãubah2h¢ubhw)År��}r��(h.U�h4}r��(h6]h7]h8]h9]h;]uh/håh)]r��h|)År��}r��(h.U�h4}r��(h6]h7]h8]h9]h;]uh/j��h)]r��hÅ)År��}r��(h.U�h4}r��(h9]r��Uid9r��ah8]h6]h7]h;]Urefidhuh/j��h)]r��hIX!���Importance of the obsolete fieldsr��ÖÅr��}r��(h.X!���Importance of the obsolete fieldsr ��h/j��ubah2häubah2hãubah2h¢ubhw)År!��}r"��(h.U�h4}r#��(h6]h7]h8]h9]h;]uh/håh)]r$��h|)År%��}r&��(h.U�h4}r'��(h6]h7]h8]h9]h;]uh/j!��h)]r(��hÅ)År)��}r*��(h.U�h4}r+��(h9]r,��Uid10r-��ah8]h6]h7]h;]Urefidh"uh/j%��h)]r.��hIX���Mutable Member Node exampler/��ÖÅr0��}r1��(h.X���Mutable Member Node exampler2��h/j)��ubah2häubah2hãubah2h¢ubeh2htubeh2h¢ubhw)År3��}r4��(h.U�h4}r5��(h6]h7]h8]h9]h;]uh/hrh)]r6��h|)År7��}r8��(h.U�h4}r9��(h6]h7]h8]h9]h;]uh/j3��h)]r:��hÅ)År;��}r<��(h.U�h4}r=��(h9]r>��Uid11r?��ah8]h6]h7]h;]Urefidh&uh/j7��h)]r@��hIX���SummaryrA��ÖÅrB��}rC��(h.X���SummaryrD��h/j;��ubah2häubah2hãubah2h¢ubeubeubh+)ÅrE��}rF��(h.U�h/h,h0h1h2h3h4}rG��(h6]h7]h8]h9]rH��h ah;]rI��h auh=K h>hh)]rJ��(h@)ÅrK��}rL��(h.h°h/jE��h0h1h2hDh4}rM��(h9]h8]h6]h7]h;]hFhúuh=K h>hh)]rN��hIX���OverviewrO��ÖÅrP��}rQ��(h.h°h/jK��ubaubh|)ÅrR��}rS��(h.X-��To support the goals of `preservation and scientific reproducibility <PreservationStrategy.html>`_, all registered objects in DataONE are considered immutable, with each object representing a published snapshot of data or metadata associated with a specific time. DataONE manages the registration, indexing, and replication of these snapshots throughout the DataONE network of Member Nodes. Upon this foundation, DataONE can guarantee that the exact byte array returned through the DataONE Read APIs (MNRead and CNRead) is the one submitted and registered.h/jE��h0h1h2hãh4}rT��(h6]h7]h8]h9]h;]uh=Kh>hh)]rU��(hIX���To support the goals of rV��ÖÅrW��}rX��(h.X���To support the goals of h/jR��ubhÅ)ÅrY��}rZ��(h.XJ���`preservation and scientific reproducibility <PreservationStrategy.html>`_h4}r[��(UnameX+���preservation and scientific reproducibilityUrefurir\��X���PreservationStrategy.htmlr]��h9]h8]h6]h7]h;]uh/jR��h)]r^��hIX+���preservation and scientific reproducibilityr_��ÖÅr`��}ra��(h.U�h/jY��ubah2häubhX)Årb��}rc��(h.X��� <PreservationStrategy.html>U referencedrd��Kh/jR��h2h[h4}re��(Urefurij]��h9]rf��hah8]h6]h7]h;]rg��hauh)]ubhIXÀ��, all registered objects in DataONE are considered immutable, with each object representing a published snapshot of data or metadata associated with a specific time. DataONE manages the registration, indexing, and replication of these snapshots throughout the DataONE network of Member Nodes. Upon this foundation, DataONE can guarantee that the exact byte array returned through the DataONE Read APIs (MNRead and CNRead) is the one submitted and registered.rh��ÖÅri��}rj��(h.XÀ��, all registered objects in DataONE are considered immutable, with each object representing a published snapshot of data or metadata associated with a specific time. DataONE manages the registration, indexing, and replication of these snapshots throughout the DataONE network of Member Nodes. Upon this foundation, DataONE can guarantee that the exact byte array returned through the DataONE Read APIs (MNRead and CNRead) is the one submitted and registered.h/jR��ubeubh|)Årk��}rl��(h.XW��Any repository that provides unique identifiers to snapshots (or revisions) can participate as DataONE Member Nodes, irrespective of whether or not they retain past snapshots. This is accomplished by the use of two identifiers, one representing the revision, and the other representing the changing (or mutable) entity. For those Member Nodes only managing the mutable entity, as long as a unique revision-level identifier is generated upon each update to the entity, DataONE will not reject the update. In situations where the rate of change is faster than DataONE's Member Node synchronization, it is possible that some snapshots will fail to be registered. However, since that revision's unique identifier is never indexed or otherwise made available, the chance for needing to retrieve that snapshot (and not finding it) in the future is very small.rm��h/jE��h0h1h2hãh4}rn��(h6]h7]h8]h9]h;]uh=Kh>hh)]ro��hIXW��Any repository that provides unique identifiers to snapshots (or revisions) can participate as DataONE Member Nodes, irrespective of whether or not they retain past snapshots. This is accomplished by the use of two identifiers, one representing the revision, and the other representing the changing (or mutable) entity. For those Member Nodes only managing the mutable entity, as long as a unique revision-level identifier is generated upon each update to the entity, DataONE will not reject the update. In situations where the rate of change is faster than DataONE's Member Node synchronization, it is possible that some snapshots will fail to be registered. However, since that revision's unique identifier is never indexed or otherwise made available, the chance for needing to retrieve that snapshot (and not finding it) in the future is very small.rp��ÖÅrq��}rr��(h.jm��h/jk��ubaubh|)Års��}rt��(h.X!���The two identifiers are known as:ru��h/jE��h0h1h2hãh4}rv��(h6]h7]h8]h9]h;]uh=K h>hh)]rw��hIX!���The two identifiers are known as:rx��ÖÅry��}rz��(h.ju��h/js��ubaubcdocutils.nodes definition_list r{��)År|��}r}��(h.U�h/jE��h0h1h2Udefinition_listr~��h4}r��(h6]h7]h8]h9]h;]uh=Nh>hh)]rÄ��(cdocutils.nodes definition_list_item rÅ��)ÅrÇ��}rÉ��(h.X∫���**Persistent Identifier (PID)** declared in the ``systemMetadata.identifier`` field. This identifier represents the snapshot or revision DataONE replicates among the DataONE federation. h/j|��h0h1h2Udefinition_list_itemrÑ��h4}rÖ��(h6]h7]h8]h9]h;]uh=K$h)]rÜ��(cdocutils.nodes term rá��)Årà��}râ��(h.X���**Persistent Identifier (PID)**rä��h/jÇ��h0h1h2Utermrã��h4}rå��(h6]h7]h8]h9]h;]uh=K$h)]rç��cdocutils.nodes strong ré��)Årè��}rê��(h.jä��h4}rë��(h6]h7]h8]h9]h;]uh/jà��h)]rí��hIX���Persistent Identifier (PID)rì��ÖÅrî��}rï��(h.U�h/jè��ubah2Ustrongrñ��ubaubcdocutils.nodes definition ró��)Årò��}rô��(h.U�h4}rö��(h6]h7]h8]h9]h;]uh/jÇ��h)]rõ��h|)Årú��}rù��(h.Xô���declared in the ``systemMetadata.identifier`` field. This identifier represents the snapshot or revision DataONE replicates among the DataONE federation.h/jò��h0h1h2hãh4}rû��(h6]h7]h8]h9]h;]uh=K#h)]rü��(hIX���declared in the r†��ÖÅr°��}r¢��(h.X���declared in the h/jú��ubcdocutils.nodes literal r£��)År§��}r•��(h.X���``systemMetadata.identifier``h4}r¶��(h6]h7]h8]h9]h;]uh/jú��h)]rß��hIX���systemMetadata.identifierr®��ÖÅr©��}r™��(h.U�h/j§��ubah2Uliteralr´��ubhIXl��� field. This identifier represents the snapshot or revision DataONE replicates among the DataONE federation.r¨��ÖÅr≠��}rÆ��(h.Xl��� field. This identifier represents the snapshot or revision DataONE replicates among the DataONE federation.h/jú��ubeubah2U definitionrØ��ubeubjÅ��)År∞��}r±��(h.XÁ���**Series Identifier (SID)** declared in the ``systemMetadata.seriesId`` field. This identifier represents the mutable content, and resolves to the latest revision among all registered revisions when used in the DataONE Read APIs. h/j|��h0h1h2jÑ��h4}r≤��(h6]h7]h8]h9]h;]uh=K)h>hh)]r≥��(já��)År¥��}rµ��(h.X���**Series Identifier (SID)**r∂��h/j∞��h0h1h2jã��h4}r∑��(h6]h7]h8]h9]h;]uh=K)h)]r∏��jé��)Årπ��}r∫��(h.j∂��h4}rª��(h6]h7]h8]h9]h;]uh/j¥��h)]rº��hIX���Series Identifier (SID)rΩ��ÖÅræ��}rø��(h.U�h/jπ��ubah2jñ��ubaubjó��)År¿��}r¡��(h.U�h4}r¬��(h6]h7]h8]h9]h;]uh/j∞��h)]r√��h|)Årƒ��}r≈��(h.X ���declared in the ``systemMetadata.seriesId`` field. This identifier represents the mutable content, and resolves to the latest revision among all registered revisions when used in the DataONE Read APIs.h/j¿��h0h1h2hãh4}r∆��(h6]h7]h8]h9]h;]uh=K'h)]r«��(hIX���declared in the r»��ÖÅr…��}r ��(h.X���declared in the h/jƒ��ubj£��)ÅrÀ��}rÃ��(h.X���``systemMetadata.seriesId``h4}rÕ��(h6]h7]h8]h9]h;]uh/jƒ��h)]rŒ��hIX���systemMetadata.seriesIdrœ��ÖÅr–��}r—��(h.U�h/jÀ��ubah2j´��ubhIXü��� field. This identifier represents the mutable content, and resolves to the latest revision among all registered revisions when used in the DataONE Read APIs.r“��ÖÅr”��}r‘��(h.Xü��� field. This identifier represents the mutable content, and resolves to the latest revision among all registered revisions when used in the DataONE Read APIs.h/jƒ��ubeubah2jØ��ubeubeubh|)År’��}r÷��(h.X⁄���DataONE relies on content originators to generate the identifiers they use for each snapshot (with the series identifier being optional) being registered, and determining which field will hold the "citable" identifier.r◊��h/jE��h0h1h2hãh4}rÿ��(h6]h7]h8]h9]h;]uh=K+h>hh)]rŸ��hIX⁄���DataONE relies on content originators to generate the identifiers they use for each snapshot (with the series identifier being optional) being registered, and determining which field will hold the "citable" identifier.r⁄��ÖÅr€��}r‹��(h.j◊��h/j’��ubaubeubh+)År›��}rfi��(h.U�h/h,h0h1h2h3h4}rfl��(h6]h7]h8]h9]r‡��hah;]r·��hauh=K1h>hh)]r‚��(h@)År„��}r‰��(h.h¥h/j›��h0h1h2hDh4}rÂ��(h9]h8]h6]h7]h;]hFhØuh=K1h>hh)]rÊ��hIX#���Changes constituting a new snapshotrÁ��ÖÅrË��}rÈ��(h.h¥h/j„��ubaubh|)ÅrÍ��}rÎ��(h.XR��DataONE considers any change that results in a different byte array of content to be a new snapshot, and thus a new object to be registered. Subtle changes, such as whitespace differences, although potentially meaningless, do therefore constitute a new object. If not properly identified with a new PID, the content held on that Member Node is invalid. Member Nodes that periodically regenerate their stored content or manipulate it upon retrieval will need to take extra care to validate checksums after regeneration or manipulation and resolve any discrepancies in content they may encounter.rÏ��h/j›��h0h1h2hãh4}rÌ��(h6]h7]h8]h9]h;]uh=K2h>hh)]rÓ��hIXR��DataONE considers any change that results in a different byte array of content to be a new snapshot, and thus a new object to be registered. Subtle changes, such as whitespace differences, although potentially meaningless, do therefore constitute a new object. If not properly identified with a new PID, the content held on that Member Node is invalid. Member Nodes that periodically regenerate their stored content or manipulate it upon retrieval will need to take extra care to validate checksums after regeneration or manipulation and resolve any discrepancies in content they may encounter.rÔ��ÖÅr��}rÒ��(h.jÏ��h/jÍ��ubaubeubh+)ÅrÚ��}rÛ��(h.U�h/h,h0h1h2h3h4}rÙ��(h6]h7]h8]h9]rı��h'ah;]rˆ��hauh=K=h>hh)]r˜��(h@)År¯��}r˘��(h.h∆h/jÚ��h0h1h2hDh4}r˙��(h9]h8]h6]h7]h;]hFh¡uh=K=h>hh)]r˚��hIX!���Changes constituting a new seriesr¸��ÖÅr˝��}r˛��(h.h∆h/j¯��ubaubh|)Årˇ��}r���(h.Xt��The SID is provided expressly to group the snapshots of a single entity that is stable over time. It was not intended to represent highly volatile entities, or those that significantly "drift" over time. Member Nodes are encouraged to instead use registered services for volatile content, and create new entities when significant change in the scope of an entity occurs.r��h/jÚ��h0h1h2hãh4}r��(h6]h7]h8]h9]h;]uh=K>h>hh)]r��hIXt��The SID is provided expressly to group the snapshots of a single entity that is stable over time. It was not intended to represent highly volatile entities, or those that significantly "drift" over time. Member Nodes are encouraged to instead use registered services for volatile content, and create new entities when significant change in the scope of an entity occurs.r��ÖÅr��}r��(h.j��h/jˇ��ubaubh|)År��}r��(h.X7��It is not clear that individual contributers will always have the means to register a service, and so may have entities organized for input, such as a file that accumulates observations. If items such as these are registered as an object, the rightsHolders should be mindful to apply reasonable temporal bounds.r ��h/jÚ��h0h1h2hãh4}r ��(h6]h7]h8]h9]h;]uh=KDh>hh)]r��hIX7��It is not clear that individual contributers will always have the means to register a service, and so may have entities organized for input, such as a file that accumulates observations. If items such as these are registered as an object, the rightsHolders should be mindful to apply reasonable temporal bounds.r��ÖÅr ��}r��(h.j ��h/j��ubaubh|)År��}r��(h.Xt��When the scope of an item has changed significantly, it is permissible to supply a new seriesId to the next snapshot while still relating the two items by obsoletes and obsoletedBy. However, it is not necessary, and may be more straightforward to simply save the new entity without relating the snapshots through system metadata, but through provenance mechanisms instead.r��h/jÚ��h0h1h2hãh4}r��(h6]h7]h8]h9]h;]uh=KIh>hh)]r��hIXt��When the scope of an item has changed significantly, it is permissible to supply a new seriesId to the next snapshot while still relating the two items by obsoletes and obsoletedBy. However, it is not necessary, and may be more straightforward to simply save the new entity without relating the snapshots through system metadata, but through provenance mechanisms instead.r��ÖÅr��}r��(h.j��h/j��ubaubeubh+)År��}r��(h.U�h/h,h0h1h2h3h4}r��(h6]h7]h8]h9]r��h#ah;]r��h auh=KQh>hh)]r��(h@)År��}r��(h.hÿh/j��h0h1h2hDh4}r��(h9]h8]h6]h7]h;]hFh”uh=KQh>hh)]r ��hIX���Usage Conventionsr!��ÖÅr"��}r#��(h.hÿh/j��ubaubh|)År$��}r%��(h.XŒ��DataONE anticipates data consumers using other contributors' data will prefer to cite using the PID, for the certainty that provides, and will prefer using the SID when citing indirectly (when citing metadata). Similarly, we anticipate content originators will wish to promote one identifier for citation. For those content providers using both identifiers, it is recommended to assign the preferred identifier according to anticipated data consumer preference.r&��h/j��h0h1h2hãh4}r'��(h6]h7]h8]h9]h;]uh=KRh>hh)]r(��hIXŒ��DataONE anticipates data consumers using other contributors' data will prefer to cite using the PID, for the certainty that provides, and will prefer using the SID when citing indirectly (when citing metadata). Similarly, we anticipate content originators will wish to promote one identifier for citation. For those content providers using both identifiers, it is recommended to assign the preferred identifier according to anticipated data consumer preference.r)��ÖÅr*��}r+��(h.j&��h/j$��ubaubeubh+)År,��}r-��(h.U�h/h,h0h1h2h3h4}r.��(h6]h7]h8]h9]r/��h!ah;]r0��hauh=K[h>hh)]r1��(h@)År2��}r3��(h.hÍh/j,��h0h1h2hDh4}r4��(h9]h8]h6]h7]h;]hFhÂuh=K[h>hh)]r5��hIX���Aggregating Download Statisticsr6��ÖÅr7��}r8��(h.hÍh/j2��ubaubh|)År9��}r:��(h.X˛���To aid in aggregating download statistics for data providers, DataONE provides the ``cn/v2/query/logsolr`` query endpoint. Both PID and SID field are included in the index records to allow straightforward retrieval of download statistics by either field.h/j,��h0h1h2hãh4}r;��(h6]h7]h8]h9]h;]uh=K\h>hh)]r<��(hIXS���To aid in aggregating download statistics for data providers, DataONE provides the r=��ÖÅr>��}r?��(h.XS���To aid in aggregating download statistics for data providers, DataONE provides the h/j9��ubj£��)År@��}rA��(h.X���``cn/v2/query/logsolr``h4}rB��(h6]h7]h8]h9]h;]uh/j9��h)]rC��hIX���cn/v2/query/logsolrrD��ÖÅrE��}rF��(h.U�h/j@��ubah2j´��ubhIXî��� query endpoint. Both PID and SID field are included in the index records to allow straightforward retrieval of download statistics by either field.rG��ÖÅrH��}rI��(h.Xî��� query endpoint. Both PID and SID field are included in the index records to allow straightforward retrieval of download statistics by either field.h/j9��ubeubeubh+)ÅrJ��}rK��(h.U�h/h,h0h1h2h3h4}rL��(h6]h7]h8]h9]rM��h$ah;]rN��hauh=Kbh>hh)]rO��(h@)ÅrP��}rQ��(h.h¸h/jJ��h0h1h2hDh4}rR��(h9]h8]h6]h7]h;]hFh˜uh=Kbh>hh)]rS��hIX%���Identifier resolution in DataONE APIsrT��ÖÅrU��}rV��(h.h¸h/jP��ubaubh|)ÅrW��}rX��(h.X ��All DataONE APIs accepting an Identifier must treat PIDs as requests for the exact snapshot, and SIDs as a request for the latest snapshot that DataONE Node has knowledge of. Due to the distributed nature of snapshot replication, it is possible that a replica Member Node not know about the latest snapshot, in which case, a request by SID to that node should give a previous snapshot. For all nodes, even the authoritative Member Node, a request by PID for a snapshot that it doesn't host must return a NotFound exception.rY��h/jJ��h0h1h2hãh4}rZ��(h6]h7]h8]h9]h;]uh=Kch>hh)]r[��hIX ��All DataONE APIs accepting an Identifier must treat PIDs as requests for the exact snapshot, and SIDs as a request for the latest snapshot that DataONE Node has knowledge of. Due to the distributed nature of snapshot replication, it is possible that a replica Member Node not know about the latest snapshot, in which case, a request by SID to that node should give a previous snapshot. For all nodes, even the authoritative Member Node, a request by PID for a snapshot that it doesn't host must return a NotFound exception.r\��ÖÅr]��}r^��(h.jY��h/jW��ubaubh|)År_��}r`��(h.X»���End users should therefore rely on ``v2.cn.resolve`` for object retrieval. If the Identifier used for the resolve is a SID, this method will return an ObjectLocationList for the latest known snapshot.h/jJ��h0h1h2hãh4}ra��(h6]h7]h8]h9]h;]uh=Kkh>hh)]rb��(hIX#���End users should therefore rely on rc��ÖÅrd��}re��(h.X#���End users should therefore rely on h/j_��ubj£��)Årf��}rg��(h.X���``v2.cn.resolve``h4}rh��(h6]h7]h8]h9]h;]uh/j_��h)]ri��hIX ���v2.cn.resolverj��ÖÅrk��}rl��(h.U�h/jf��ubah2j´��ubhIXî��� for object retrieval. If the Identifier used for the resolve is a SID, this method will return an ObjectLocationList for the latest known snapshot.rm��ÖÅrn��}ro��(h.Xî��� for object retrieval. If the Identifier used for the resolve is a SID, this method will return an ObjectLocationList for the latest known snapshot.h/j_��ubeubeubh+)Årp��}rq��(h.U�h/h,h0h1h2h3h4}rr��(h6]h7]h8]h9]rs��hah;]rt��h auh=Kqh>hh)]ru��(h@)Årv��}rw��(h.j��h/jp��h0h1h2hDh4}rx��(h9]h8]h6]h7]h;]hFj ��uh=Kqh>hh)]ry��hIX1���Series Identifier resolution to the head revisionrz��ÖÅr{��}r|��(h.j��h/jv��ubaubh|)År}��}r~��(h.X€��The primary way for determining the head of a series is via the ``obsoletedBy`` field in the system metadata that links to the next snapshot in the chain. With all of the snapshots synchronized, there should only be one of the series that is not obsolete, and that is the head. With incomplete synchronization, there will be possibly more than one snapshot that is not obsoleted, and in these cases, the one with the latest ``dateUploaded`` value will be chosen as the head.h/jp��h0h1h2hãh4}r��(h6]h7]h8]h9]h;]uh=Krh>hh)]rÄ��(hIX@���The primary way for determining the head of a series is via the rÅ��ÖÅrÇ��}rÉ��(h.X@���The primary way for determining the head of a series is via the h/j}��ubj£��)ÅrÑ��}rÖ��(h.X���``obsoletedBy``h4}rÜ��(h6]h7]h8]h9]h;]uh/j}��h)]rá��hIX���obsoletedByrà��ÖÅrâ��}rä��(h.U�h/jÑ��ubah2j´��ubhIXZ�� field in the system metadata that links to the next snapshot in the chain. With all of the snapshots synchronized, there should only be one of the series that is not obsolete, and that is the head. With incomplete synchronization, there will be possibly more than one snapshot that is not obsoleted, and in these cases, the one with the latest rã��ÖÅrå��}rç��(h.XZ�� field in the system metadata that links to the next snapshot in the chain. With all of the snapshots synchronized, there should only be one of the series that is not obsolete, and that is the head. With incomplete synchronization, there will be possibly more than one snapshot that is not obsoleted, and in these cases, the one with the latest h/j}��ubj£��)Åré��}rè��(h.X���``dateUploaded``h4}rê��(h6]h7]h8]h9]h;]uh/j}��h)]rë��hIX���dateUploadedrí��ÖÅrì��}rî��(h.U�h/jé��ubah2j´��ubhIX"��� value will be chosen as the head.rï��ÖÅrñ��}ró��(h.X"��� value will be chosen as the head.h/j}��ubeubh|)Årò��}rô��(h.X��Use of the obsoleted fields as the primary indicator for the head of the series is preferred because it is a direct reflection of the rightsHolder's intentions, whereas the ``dateUploaded`` value is only a reflection of the order in which the Member Node processes uploaded content.h/jp��h0h1h2hãh4}rö��(h6]h7]h8]h9]h;]uh=Kyh>hh)]rõ��(hIX≠���Use of the obsoleted fields as the primary indicator for the head of the series is preferred because it is a direct reflection of the rightsHolder's intentions, whereas the rú��ÖÅrù��}rû��(h.X≠���Use of the obsoleted fields as the primary indicator for the head of the series is preferred because it is a direct reflection of the rightsHolder's intentions, whereas the h/jò��ubj£��)Årü��}r†��(h.X���``dateUploaded``h4}r°��(h6]h7]h8]h9]h;]uh/jò��h)]r¢��hIX���dateUploadedr£��ÖÅr§��}r•��(h.U�h/jü��ubah2j´��ubhIX]��� value is only a reflection of the order in which the Member Node processes uploaded content.r¶��ÖÅrß��}r®��(h.X]��� value is only a reflection of the order in which the Member Node processes uploaded content.h/jò��ubeubeubh+)År©��}r™��(h.U�h/h,h0h1h2h3h4}r´��(h6]h7]h8]h9]r¨��hah;]r≠��hauh=Kh>hh)]rÆ��(h@)ÅrØ��}r∞��(h.j ��h/j©��h0h1h2hDh4}r±��(h9]h8]h6]h7]h;]hFj��uh=Kh>hh)]r≤��hIX!���Importance of the obsolete fieldsr≥��ÖÅr¥��}rµ��(h.j ��h/jØ��ubaubh|)År∂��}r∑��(h.X=��Member Nodes that manage by mutable entity (don't preserve prior snapshots) should populate the ``obsoletes`` and ``obsoletedBy`` fields, even if they do not plan to preserve older snapshots. Replica nodes and the DataONE Coordinating Nodes can use these fields to optimize queries for finding the head of the series.h/j©��h0h1h2hãh4}r∏��(h6]h7]h8]h9]h;]uh=KÄh>hh)]rπ��(hIX`���Member Nodes that manage by mutable entity (don't preserve prior snapshots) should populate the r∫��ÖÅrª��}rº��(h.X`���Member Nodes that manage by mutable entity (don't preserve prior snapshots) should populate the h/j∂��ubj£��)ÅrΩ��}ræ��(h.X ���``obsoletes``h4}rø��(h6]h7]h8]h9]h;]uh/j∂��h)]r¿��hIX ���obsoletesr¡��ÖÅr¬��}r√��(h.U�h/jΩ��ubah2j´��ubhIX��� and rƒ��ÖÅr≈��}r∆��(h.X��� and h/j∂��ubj£��)År«��}r»��(h.X���``obsoletedBy``h4}r…��(h6]h7]h8]h9]h;]uh/j∂��h)]r ��hIX���obsoletedByrÀ��ÖÅrÃ��}rÕ��(h.U�h/j«��ubah2j´��ubhIXº��� fields, even if they do not plan to preserve older snapshots. Replica nodes and the DataONE Coordinating Nodes can use these fields to optimize queries for finding the head of the series.rŒ��ÖÅrœ��}r–��(h.Xº��� fields, even if they do not plan to preserve older snapshots. Replica nodes and the DataONE Coordinating Nodes can use these fields to optimize queries for finding the head of the series.h/j∂��ubeubh|)År—��}r“��(h.X˙���*Question: should mutable Member Nodes keep systemMetadata documents for snapshots they no longer have? (it would allow the obsoletedBy fields to be synchronized, but would it be in conflict with the behavior of deleted items (and would it matter?)*r”��h/j©��h0h1h2hãh4}r‘��(h6]h7]h8]h9]h;]uh=KÖh>hh)]r’��cdocutils.nodes emphasis r÷��)År◊��}rÿ��(h.j”��h4}rŸ��(h6]h7]h8]h9]h;]uh/j—��h)]r⁄��hIX¯���Question: should mutable Member Nodes keep systemMetadata documents for snapshots they no longer have? (it would allow the obsoletedBy fields to be synchronized, but would it be in conflict with the behavior of deleted items (and would it matter?)r€��ÖÅr‹��}r›��(h.U�h/j◊��ubah2Uemphasisrfi��ubaubeubh+)Årfl��}r‡��(h.U�h/h,h0h1h2h3h4}r·��(h6]h7]h8]h9]r‚��h"ah;]r„��hauh=Käh>hh)]r‰��(h@)ÅrÂ��}rÊ��(h.j2��h/jfl��h0h1h2hDh4}rÁ��(h9]h8]h6]h7]h;]hFj-��uh=Käh>hh)]rË��hIX���Mutable Member Node examplerÈ��ÖÅrÍ��}rÎ��(h.j2��h/jÂ��ubaubh|)ÅrÏ��}rÌ��(h.X[��To illustrate by way of example, author **A** uploads an item to Member Node **M**, with an identifier **S** not using the DataONE API, but with **M**'s primary API. **M** builds a systemMetadata document for **S**, generating a PID, **P1**, to uniquely identify the initial snapshot, and assigns an upload date of **D1**, and uses the identifier **S** for the seriesId. DataONE synchronizes the object, and replicates the snapshot **P1** to one other Member Node **R1**. The author, **A**, then saves changes to the item, whereupon **M** generates another PID, **P2**, to uniquely identifier this newer snapshot, uses **S** in the seriesId field, puts **P1** in the obsoletes field, and **D2** in the dateUploaded field. (size and checksum are also calculated for the new snapshot.) This is synchronized and replicated to a different Member Node, **R2**.h/jfl��h0h1h2hãh4}rÓ��(h6]h7]h8]h9]h;]uh=Kãh>hh)]rÔ��(hIX(���To illustrate by way of example, author r��ÖÅrÒ��}rÚ��(h.X(���To illustrate by way of example, author h/jÏ��ubjé��)ÅrÛ��}rÙ��(h.X���**A**h4}rı��(h6]h7]h8]h9]h;]uh/jÏ��h)]rˆ��hIX���AÖÅr˜��}r¯��(h.U�h/jÛ��ubah2jñ��ubhIX ��� uploads an item to Member Node r˘��ÖÅr˙��}r˚��(h.X ��� uploads an item to Member Node h/jÏ��ubjé��)År¸��}r˝��(h.X���**M**h4}r˛��(h6]h7]h8]h9]h;]uh/jÏ��h)]rˇ��hIX���MÖÅr���}r��(h.U�h/j¸��ubah2jñ��ubhIX���, with an identifier r��ÖÅr��}r��(h.X���, with an identifier h/jÏ��ubjé��)År��}r��(h.X���**S**h4}r��(h6]h7]h8]h9]h;]uh/jÏ��h)]r��hIX���SÖÅr ��}r ��(h.U�h/j��ubah2jñ��ubhIX%��� not using the DataONE API, but with r��ÖÅr��}r ��(h.X%��� not using the DataONE API, but with h/jÏ��ubjé��)År��}r��(h.X���**M**h4}r��(h6]h7]h8]h9]h;]uh/jÏ��h)]r��hIX���MÖÅr��}r��(h.U�h/j��ubah2jñ��ubhIX���'s primary API. r��ÖÅr��}r��(h.X���'s primary API. h/jÏ��ubjé��)År��}r��(h.X���**M**h4}r��(h6]h7]h8]h9]h;]uh/jÏ��h)]r��hIX���MÖÅr��}r��(h.U�h/j��ubah2jñ��ubhIX&��� builds a systemMetadata document for r��ÖÅr��}r��(h.X&��� builds a systemMetadata document for h/jÏ��ubjé��)År ��}r!��(h.X���**S**h4}r"��(h6]h7]h8]h9]h;]uh/jÏ��h)]r#��hIX���SÖÅr$��}r%��(h.U�h/j ��ubah2jñ��ubhIX���, generating a PID, r&��ÖÅr'��}r(��(h.X���, generating a PID, h/jÏ��ubjé��)År)��}r*��(h.X���**P1**h4}r+��(h6]h7]h8]h9]h;]uh/jÏ��h)]r,��hIX���P1r-��ÖÅr.��}r/��(h.U�h/j)��ubah2jñ��ubhIXK���, to uniquely identify the initial snapshot, and assigns an upload date of r0��ÖÅr1��}r2��(h.XK���, to uniquely identify the initial snapshot, and assigns an upload date of h/jÏ��ubjé��)År3��}r4��(h.X���**D1**h4}r5��(h6]h7]h8]h9]h;]uh/jÏ��h)]r6��hIX���D1r7��ÖÅr8��}r9��(h.U�h/j3��ubah2jñ��ubhIX���, and uses the identifier r:��ÖÅr;��}r<��(h.X���, and uses the identifier h/jÏ��ubjé��)År=��}r>��(h.X���**S**h4}r?��(h6]h7]h8]h9]h;]uh/jÏ��h)]r@��hIX���SÖÅrA��}rB��(h.U�h/j=��ubah2jñ��ubhIXQ��� for the seriesId. DataONE synchronizes the object, and replicates the snapshot rC��ÖÅrD��}rE��(h.XQ��� for the seriesId. DataONE synchronizes the object, and replicates the snapshot h/jÏ��ubjé��)ÅrF��}rG��(h.X���**P1**h4}rH��(h6]h7]h8]h9]h;]uh/jÏ��h)]rI��hIX���P1rJ��ÖÅrK��}rL��(h.U�h/jF��ubah2jñ��ubhIX��� to one other Member Node rM��ÖÅrN��}rO��(h.X��� to one other Member Node h/jÏ��ubjé��)ÅrP��}rQ��(h.X���**R1**h4}rR��(h6]h7]h8]h9]h;]uh/jÏ��h)]rS��hIX���R1rT��ÖÅrU��}rV��(h.U�h/jP��ubah2jñ��ubhIX���. The author, rW��ÖÅrX��}rY��(h.X���. The author, h/jÏ��ubjé��)ÅrZ��}r[��(h.X���**A**h4}r\��(h6]h7]h8]h9]h;]uh/jÏ��h)]r]��hIX���AÖÅr^��}r_��(h.U�h/jZ��ubah2jñ��ubhIX,���, then saves changes to the item, whereupon r`��ÖÅra��}rb��(h.X,���, then saves changes to the item, whereupon h/jÏ��ubjé��)Årc��}rd��(h.X���**M**h4}re��(h6]h7]h8]h9]h;]uh/jÏ��h)]rf��hIX���MÖÅrg��}rh��(h.U�h/jc��ubah2jñ��ubhIX��� generates another PID, ri��ÖÅrj��}rk��(h.X��� generates another PID, h/jÏ��ubjé��)Årl��}rm��(h.X���**P2**h4}rn��(h6]h7]h8]h9]h;]uh/jÏ��h)]ro��hIX���P2rp��ÖÅrq��}rr��(h.U�h/jl��ubah2jñ��ubhIX3���, to uniquely identifier this newer snapshot, uses rs��ÖÅrt��}ru��(h.X3���, to uniquely identifier this newer snapshot, uses h/jÏ��ubjé��)Årv��}rw��(h.X���**S**h4}rx��(h6]h7]h8]h9]h;]uh/jÏ��h)]ry��hIX���SÖÅrz��}r{��(h.U�h/jv��ubah2jñ��ubhIX��� in the seriesId field, puts r|��ÖÅr}��}r~��(h.X��� in the seriesId field, puts h/jÏ��ubjé��)År��}rÄ��(h.X���**P1**h4}rÅ��(h6]h7]h8]h9]h;]uh/jÏ��h)]rÇ��hIX���P1rÉ��ÖÅrÑ��}rÖ��(h.U�h/j��ubah2jñ��ubhIX��� in the obsoletes field, and rÜ��ÖÅrá��}rà��(h.X��� in the obsoletes field, and h/jÏ��ubjé��)Årâ��}rä��(h.X���**D2**h4}rã��(h6]h7]h8]h9]h;]uh/jÏ��h)]rå��hIX���D2rç��ÖÅré��}rè��(h.U�h/jâ��ubah2jñ��ubhIXú��� in the dateUploaded field. (size and checksum are also calculated for the new snapshot.) This is synchronized and replicated to a different Member Node, rê��ÖÅrë��}rí��(h.Xú��� in the dateUploaded field. (size and checksum are also calculated for the new snapshot.) This is synchronized and replicated to a different Member Node, h/jÏ��ubjé��)Årì��}rî��(h.X���**R2**h4}rï��(h6]h7]h8]h9]h;]uh/jÏ��h)]rñ��hIX���R2ró��ÖÅrò��}rô��(h.U�h/jì��ubah2jñ��ubhIX���.ÖÅrö��}rõ��(h.X���.h/jÏ��ubeubh|)Årú��}rù��(h.X��When ``v2.cn.resolve(S`)`` is called, an ObjectLocationList for **P2** is returned, listing Member Nodes **M** and **R2** as locations for retrieval. A call to ``M.get(P2)`` or ``R2.get(P2)`` will return the latest snapshot, as will the same call using **S** as the identifier instead. However, a call to ``R1.get(P2)`` will return NotFound, because it was not a replication target for that snapshot, and a call to ``R1.get(S)`` will return the initial snapshot, because it has snapshot **P1** with the associated seriesId **S**.h/jfl��h0h1h2hãh4}rû��(h6]h7]h8]h9]h;]uh=Kñh>hh)]rü��(hIX���When r†��ÖÅr°��}r¢��(h.X���When h/jú��ubj£��)År£��}r§��(h.X���``v2.cn.resolve(S`)``h4}r•��(h6]h7]h8]h9]h;]uh/jú��h)]r¶��hIX���v2.cn.resolve(S`)rß��ÖÅr®��}r©��(h.U�h/j£��ubah2j´��ubhIX&��� is called, an ObjectLocationList for r™��ÖÅr´��}r¨��(h.X&��� is called, an ObjectLocationList for h/jú��ubjé��)År≠��}rÆ��(h.X���**P2**h4}rØ��(h6]h7]h8]h9]h;]uh/jú��h)]r∞��hIX���P2r±��ÖÅr≤��}r≥��(h.U�h/j≠��ubah2jñ��ubhIX#��� is returned, listing Member Nodes r¥��ÖÅrµ��}r∂��(h.X#��� is returned, listing Member Nodes h/jú��ubjé��)År∑��}r∏��(h.X���**M**h4}rπ��(h6]h7]h8]h9]h;]uh/jú��h)]r∫��hIX���MÖÅrª��}rº��(h.U�h/j∑��ubah2jñ��ubhIX��� and rΩ��ÖÅræ��}rø��(h.X��� and h/jú��ubjé��)År¿��}r¡��(h.X���**R2**h4}r¬��(h6]h7]h8]h9]h;]uh/jú��h)]r√��hIX���R2rƒ��ÖÅr≈��}r∆��(h.U�h/j¿��ubah2jñ��ubhIX(��� as locations for retrieval. A call to r«��ÖÅr»��}r…��(h.X(��� as locations for retrieval. A call to h/jú��ubj£��)År ��}rÀ��(h.X ���``M.get(P2)``h4}rÃ��(h6]h7]h8]h9]h;]uh/jú��h)]rÕ��hIX ���M.get(P2)rŒ��ÖÅrœ��}r–��(h.U�h/j ��ubah2j´��ubhIX��� or r—��ÖÅr“��}r”��(h.X��� or h/jú��ubj£��)År‘��}r’��(h.X���``R2.get(P2)``h4}r÷��(h6]h7]h8]h9]h;]uh/jú��h)]r◊��hIX ���R2.get(P2)rÿ��ÖÅrŸ��}r⁄��(h.U�h/j‘��ubah2j´��ubhIX>��� will return the latest snapshot, as will the same call using r€��ÖÅr‹��}r›��(h.X>��� will return the latest snapshot, as will the same call using h/jú��ubjé��)Årfi��}rfl��(h.X���**S**h4}r‡��(h6]h7]h8]h9]h;]uh/jú��h)]r·��hIX���SÖÅr‚��}r„��(h.U�h/jfi��ubah2jñ��ubhIX0��� as the identifier instead. However, a call to r‰��ÖÅrÂ��}rÊ��(h.X0��� as the identifier instead. However, a call to h/jú��ubj£��)ÅrÁ��}rË��(h.X���``R1.get(P2)``h4}rÈ��(h6]h7]h8]h9]h;]uh/jú��h)]rÍ��hIX ���R1.get(P2)rÎ��ÖÅrÏ��}rÌ��(h.U�h/jÁ��ubah2j´��ubhIX`��� will return NotFound, because it was not a replication target for that snapshot, and a call to rÓ��ÖÅrÔ��}r��(h.X`��� will return NotFound, because it was not a replication target for that snapshot, and a call to h/jú��ubj£��)ÅrÒ��}rÚ��(h.X ���``R1.get(S)``h4}rÛ��(h6]h7]h8]h9]h;]uh/jú��h)]rÙ��hIX ���R1.get(S)rı��ÖÅrˆ��}r˜��(h.U�h/jÒ��ubah2j´��ubhIX;��� will return the initial snapshot, because it has snapshot r¯��ÖÅr˘��}r˙��(h.X;��� will return the initial snapshot, because it has snapshot h/jú��ubjé��)År˚��}r¸��(h.X���**P1**h4}r˝��(h6]h7]h8]h9]h;]uh/jú��h)]r˛��hIX���P1rˇ��ÖÅr���}r��(h.U�h/j˚��ubah2jñ��ubhIX��� with the associated seriesId r��ÖÅr��}r��(h.X��� with the associated seriesId h/jú��ubjé��)År��}r��(h.X���**S**h4}r��(h6]h7]h8]h9]h;]uh/jú��h)]r��hIX���SÖÅr ��}r ��(h.U�h/j��ubah2jñ��ubhIX���.ÖÅr��}r��(h.X���.h/jú��ubeubh|)År ��}r��(h.XQ��Notice, too, that ``v2.cn.resolve(P1)`` will return an ObjectLocationList containing both **M** and **R1**, although retrieval from **M** is no longer possible, since **M** doesn't preserve past snapshots. ``M.get(P1)`` should return a NotFound, and the client will move on to **R1**, and be able to retrieve **P1** with ``R1.get(P1)``.h/jfl��h0h1h2hãh4}r��(h6]h7]h8]h9]h;]uh=Kùh>hh)]r��(hIX���Notice, too, that r��ÖÅr��}r��(h.X���Notice, too, that h/j ��ubj£��)År��}r��(h.X���``v2.cn.resolve(P1)``h4}r��(h6]h7]h8]h9]h;]uh/j ��h)]r��hIX���v2.cn.resolve(P1)r��ÖÅr��}r��(h.U�h/j��ubah2j´��ubhIX3��� will return an ObjectLocationList containing both r��ÖÅr��}r��(h.X3��� will return an ObjectLocationList containing both h/j ��ubjé��)År��}r��(h.X���**M**h4}r ��(h6]h7]h8]h9]h;]uh/j ��h)]r!��hIX���MÖÅr"��}r#��(h.U�h/j��ubah2jñ��ubhIX��� and r$��ÖÅr%��}r&��(h.X��� and h/j ��ubjé��)År'��}r(��(h.X���**R1**h4}r)��(h6]h7]h8]h9]h;]uh/j ��h)]r*��hIX���R1r+��ÖÅr,��}r-��(h.U�h/j'��ubah2jñ��ubhIX���, although retrieval from r.��ÖÅr/��}r0��(h.X���, although retrieval from h/j ��ubjé��)År1��}r2��(h.X���**M**h4}r3��(h6]h7]h8]h9]h;]uh/j ��h)]r4��hIX���MÖÅr5��}r6��(h.U�h/j1��ubah2jñ��ubhIX��� is no longer possible, since r7��ÖÅr8��}r9��(h.X��� is no longer possible, since h/j ��ubjé��)År:��}r;��(h.X���**M**h4}r<��(h6]h7]h8]h9]h;]uh/j ��h)]r=��hIX���MÖÅr>��}r?��(h.U�h/j:��ubah2jñ��ubhIX#��� doesn't preserve past snapshots. r@��ÖÅrA��}rB��(h.X#��� doesn't preserve past snapshots. h/j ��ubj£��)ÅrC��}rD��(h.X ���``M.get(P1)``h4}rE��(h6]h7]h8]h9]h;]uh/j ��h)]rF��hIX ���M.get(P1)rG��ÖÅrH��}rI��(h.U�h/jC��ubah2j´��ubhIX:��� should return a NotFound, and the client will move on to rJ��ÖÅrK��}rL��(h.X:��� should return a NotFound, and the client will move on to h/j ��ubjé��)ÅrM��}rN��(h.X���**R1**h4}rO��(h6]h7]h8]h9]h;]uh/j ��h)]rP��hIX���R1rQ��ÖÅrR��}rS��(h.U�h/jM��ubah2jñ��ubhIX���, and be able to retrieve rT��ÖÅrU��}rV��(h.X���, and be able to retrieve h/j ��ubjé��)ÅrW��}rX��(h.X���**P1**h4}rY��(h6]h7]h8]h9]h;]uh/j ��h)]rZ��hIX���P1r[��ÖÅr\��}r]��(h.U�h/jW��ubah2jñ��ubhIX��� with r^��ÖÅr_��}r`��(h.X��� with h/j ��ubj£��)Åra��}rb��(h.X���``R1.get(P1)``h4}rc��(h6]h7]h8]h9]h;]uh/j ��h)]rd��hIX ���R1.get(P1)re��ÖÅrf��}rg��(h.U�h/ja��ubah2j´��ubhIX���.ÖÅrh��}ri��(h.X���.h/j ��ubeubh|)Årj��}rk��(h.Xfi��The CN, when ``v2.cn.resolve(S)`` was called, determined the head of the series by first finding all of the snapshots where the seriesId is **S**, and obsoletedBy is null or the obsoletedBy object has a different seriesId. In this case, since the **P1** systemMetadata is never updated to fill in the obsoletedBy field, the algorithm will get both **P1** and **P2**. It will then notice that **P2** has the later date of **D2**, so will choose **P2** as the head of the series.h/jfl��h0h1h2hãh4}rl��(h6]h7]h8]h9]h;]uh=K¢h>hh)]rm��(hIX ���The CN, when rn��ÖÅro��}rp��(h.X ���The CN, when h/jj��ubj£��)Årq��}rr��(h.X���``v2.cn.resolve(S)``h4}rs��(h6]h7]h8]h9]h;]uh/jj��h)]rt��hIX���v2.cn.resolve(S)ru��ÖÅrv��}rw��(h.U�h/jq��ubah2j´��ubhIXk��� was called, determined the head of the series by first finding all of the snapshots where the seriesId is rx��ÖÅry��}rz��(h.Xk��� was called, determined the head of the series by first finding all of the snapshots where the seriesId is h/jj��ubjé��)År{��}r|��(h.X���**S**h4}r}��(h6]h7]h8]h9]h;]uh/jj��h)]r~��hIX���SÖÅr��}rÄ��(h.U�h/j{��ubah2jñ��ubhIXf���, and obsoletedBy is null or the obsoletedBy object has a different seriesId. In this case, since the rÅ��ÖÅrÇ��}rÉ��(h.Xf���, and obsoletedBy is null or the obsoletedBy object has a different seriesId. In this case, since the h/jj��ubjé��)ÅrÑ��}rÖ��(h.X���**P1**h4}rÜ��(h6]h7]h8]h9]h;]uh/jj��h)]rá��hIX���P1rà��ÖÅrâ��}rä��(h.U�h/jÑ��ubah2jñ��ubhIX_��� systemMetadata is never updated to fill in the obsoletedBy field, the algorithm will get both rã��ÖÅrå��}rç��(h.X_��� systemMetadata is never updated to fill in the obsoletedBy field, the algorithm will get both h/jj��ubjé��)Åré��}rè��(h.X���**P1**h4}rê��(h6]h7]h8]h9]h;]uh/jj��h)]rë��hIX���P1rí��ÖÅrì��}rî��(h.U�h/jé��ubah2jñ��ubhIX��� and rï��ÖÅrñ��}ró��(h.X��� and h/jj��ubjé��)Årò��}rô��(h.X���**P2**h4}rö��(h6]h7]h8]h9]h;]uh/jj��h)]rõ��hIX���P2rú��ÖÅrù��}rû��(h.U�h/jò��ubah2jñ��ubhIX���. It will then notice that rü��ÖÅr†��}r°��(h.X���. It will then notice that h/jj��ubjé��)År¢��}r£��(h.X���**P2**h4}r§��(h6]h7]h8]h9]h;]uh/jj��h)]r•��hIX���P2r¶��ÖÅrß��}r®��(h.U�h/j¢��ubah2jñ��ubhIX��� has the later date of r©��ÖÅr™��}r´��(h.X��� has the later date of h/jj��ubjé��)År¨��}r≠��(h.X���**D2**h4}rÆ��(h6]h7]h8]h9]h;]uh/jj��h)]rØ��hIX���D2r∞��ÖÅr±��}r≤��(h.U�h/j¨��ubah2jñ��ubhIX���, so will choose r≥��ÖÅr¥��}rµ��(h.X���, so will choose h/jj��ubjé��)År∂��}r∑��(h.X���**P2**h4}r∏��(h6]h7]h8]h9]h;]uh/jj��h)]rπ��hIX���P2r∫��ÖÅrª��}rº��(h.U�h/j∂��ubah2jñ��ubhIX��� as the head of the series.rΩ��ÖÅræ��}rø��(h.X��� as the head of the series.h/jj��ubeubh|)År¿��}r¡��(h.X��Suppose now that **A** spawns two more snapshots in quick succession, and DataONE synchronizes afterwards. It missed **P3(S)** but picks up **P4(S)**. ``Cn.resolve(S)`` will return an ObjectLocationList for the **P4** snapshot, since it is the latest of all non-obsoleted snapshots.h/jfl��h0h1h2hãh4}r¬��(h6]h7]h8]h9]h;]uh=K©h>hh)]r√��(hIX���Suppose now that rƒ��ÖÅr≈��}r∆��(h.X���Suppose now that h/j¿��ubjé��)År«��}r»��(h.X���**A**h4}r…��(h6]h7]h8]h9]h;]uh/j¿��h)]r ��hIX���AÖÅrÀ��}rÃ��(h.U�h/j«��ubah2jñ��ubhIX`��� spawns two more snapshots in quick succession, and DataONE synchronizes afterwards. It missed rÕ��ÖÅrŒ��}rœ��(h.X`��� spawns two more snapshots in quick succession, and DataONE synchronizes afterwards. It missed h/j¿��ubjé��)År–��}r—��(h.X ���**P3(S)**h4}r“��(h6]h7]h8]h9]h;]uh/j¿��h)]r”��hIX���P3(S)r‘��ÖÅr’��}r÷��(h.U�h/j–��ubah2jñ��ubhIX��� but picks up r◊��ÖÅrÿ��}rŸ��(h.X��� but picks up h/j¿��ubjé��)År⁄��}r€��(h.X ���**P4(S)**h4}r‹��(h6]h7]h8]h9]h;]uh/j¿��h)]r›��hIX���P4(S)rfi��ÖÅrfl��}r‡��(h.U�h/j⁄��ubah2jñ��ubhIX���. r·��ÖÅr‚��}r„��(h.X���. h/j¿��ubj£��)År‰��}rÂ��(h.X���``Cn.resolve(S)``h4}rÊ��(h6]h7]h8]h9]h;]uh/j¿��h)]rÁ��hIX ���Cn.resolve(S)rË��ÖÅrÈ��}rÍ��(h.U�h/j‰��ubah2j´��ubhIX+��� will return an ObjectLocationList for the rÎ��ÖÅrÏ��}rÌ��(h.X+��� will return an ObjectLocationList for the h/j¿��ubjé��)ÅrÓ��}rÔ��(h.X���**P4**h4}r��(h6]h7]h8]h9]h;]uh/j¿��h)]rÒ��hIX���P4rÚ��ÖÅrÛ��}rÙ��(h.U�h/jÓ��ubah2jñ��ubhIXA��� snapshot, since it is the latest of all non-obsoleted snapshots.rı��ÖÅrˆ��}r˜��(h.XA��� snapshot, since it is the latest of all non-obsoleted snapshots.h/j¿��ubeubh|)År¯��}r˘��(h.Xä��Later, **A** makes some changes and realizes that the content is significantly different from previous revisions, so renames it **S2**. The system treats it as related, so links to the **P4** snapshot with the obsoletes field. **P5(S2)** is now hosted on **M**, but **P4(S)** is gone. ``cn.resolve(S)`` will return an ObjectLocationList for **P4**, but ``M.get(P4)`` will return NotFound, and the client will have to retrieve from a replica Member Node, if possible. ``Cn.resolve(S2)`` will return an OLL for **P5**. Note also that ``M.get(S)`` will not be able to resolve the SID to any PID, since it doesn't host any of the snapshots of **S**.h/jfl��h0h1h2hãh4}r˙��(h6]h7]h8]h9]h;]uh=KÆh>hh)]r˚��(hIX���Later, r¸��ÖÅr˝��}r˛��(h.X���Later, h/j¯��ubjé��)Årˇ��}r���(h.X���**A**h4}r��(h6]h7]h8]h9]h;]uh/j¯��h)]r��hIX���AÖÅr��}r��(h.U�h/jˇ��ubah2jñ��ubhIXt��� makes some changes and realizes that the content is significantly different from previous revisions, so renames it r��ÖÅr��}r��(h.Xt��� makes some changes and realizes that the content is significantly different from previous revisions, so renames it h/j¯��ubjé��)År��}r ��(h.X���**S2**h4}r ��(h6]h7]h8]h9]h;]uh/j¯��h)]r��hIX���S2r��ÖÅr ��}r��(h.U�h/j��ubah2jñ��ubhIX4���. The system treats it as related, so links to the r��ÖÅr��}r��(h.X4���. The system treats it as related, so links to the h/j¯��ubjé��)År��}r��(h.X���**P4**h4}r��(h6]h7]h8]h9]h;]uh/j¯��h)]r��hIX���P4r��ÖÅr��}r��(h.U�h/j��ubah2jñ��ubhIX%��� snapshot with the obsoletes field. r��ÖÅr��}r��(h.X%��� snapshot with the obsoletes field. h/j¯��ubjé��)År��}r��(h.X ���**P5(S2)**h4}r��(h6]h7]h8]h9]h;]uh/j¯��h)]r��hIX���P5(S2)r ��ÖÅr!��}r"��(h.U�h/j��ubah2jñ��ubhIX��� is now hosted on r#��ÖÅr$��}r%��(h.X��� is now hosted on h/j¯��ubjé��)År&��}r'��(h.X���**M**h4}r(��(h6]h7]h8]h9]h;]uh/j¯��h)]r)��hIX���MÖÅr*��}r+��(h.U�h/j&��ubah2jñ��ubhIX���, but r,��ÖÅr-��}r.��(h.X���, but h/j¯��ubjé��)År/��}r0��(h.X ���**P4(S)**h4}r1��(h6]h7]h8]h9]h;]uh/j¯��h)]r2��hIX���P4(S)r3��ÖÅr4��}r5��(h.U�h/j/��ubah2jñ��ubhIX��� is gone. r6��ÖÅr7��}r8��(h.X��� is gone. h/j¯��ubj£��)År9��}r:��(h.X���``cn.resolve(S)``h4}r;��(h6]h7]h8]h9]h;]uh/j¯��h)]r<��hIX ���cn.resolve(S)r=��ÖÅr>��}r?��(h.U�h/j9��ubah2j´��ubhIX'��� will return an ObjectLocationList for r@��ÖÅrA��}rB��(h.X'��� will return an ObjectLocationList for h/j¯��ubjé��)ÅrC��}rD��(h.X���**P4**h4}rE��(h6]h7]h8]h9]h;]uh/j¯��h)]rF��hIX���P4rG��ÖÅrH��}rI��(h.U�h/jC��ubah2jñ��ubhIX���, but rJ��ÖÅrK��}rL��(h.X���, but h/j¯��ubj£��)ÅrM��}rN��(h.X ���``M.get(P4)``h4}rO��(h6]h7]h8]h9]h;]uh/j¯��h)]rP��hIX ���M.get(P4)rQ��ÖÅrR��}rS��(h.U�h/jM��ubah2j´��ubhIXf��� will return NotFound, and the client will have to retrieve from a replica Member Node, if possible. rT��ÖÅrU��}rV��(h.Xf��� will return NotFound, and the client will have to retrieve from a replica Member Node, if possible. h/j¯��ubj£��)ÅrW��}rX��(h.X���``Cn.resolve(S2)``h4}rY��(h6]h7]h8]h9]h;]uh/j¯��h)]rZ��hIX���Cn.resolve(S2)r[��ÖÅr\��}r]��(h.U�h/jW��ubah2j´��ubhIX��� will return an OLL for r^��ÖÅr_��}r`��(h.X��� will return an OLL for h/j¯��ubjé��)Åra��}rb��(h.X���**P5**h4}rc��(h6]h7]h8]h9]h;]uh/j¯��h)]rd��hIX���P5re��ÖÅrf��}rg��(h.U�h/ja��ubah2jñ��ubhIX���. Note also that rh��ÖÅri��}rj��(h.X���. Note also that h/j¯��ubj£��)Årk��}rl��(h.X���``M.get(S)``h4}rm��(h6]h7]h8]h9]h;]uh/j¯��h)]rn��hIX���M.get(S)ro��ÖÅrp��}rq��(h.U�h/jk��ubah2j´��ubhIX_��� will not be able to resolve the SID to any PID, since it doesn't host any of the snapshots of rr��ÖÅrs��}rt��(h.X_��� will not be able to resolve the SID to any PID, since it doesn't host any of the snapshots of h/j¯��ubjé��)Åru��}rv��(h.X���**S**h4}rw��(h6]h7]h8]h9]h;]uh/j¯��h)]rx��hIX���SÖÅry��}rz��(h.U�h/ju��ubah2jñ��ubhIX���.ÖÅr{��}r|��(h.X���.h/j¯��ubeubeubeubh+)År}��}r~��(h.U�h/hh0h1h2h3h4}r��(h6]h7]h8]h9]rÄ��h&ah;]rÅ��hauh=Kπh>hh)]rÇ��(h@)ÅrÉ��}rÑ��(h.jD��h/j}��h0h1h2hDh4}rÖ��(h9]h8]h6]h7]h;]hFj?��uh=Kπh>hh)]rÜ��hIX���Summaryrá��ÖÅrà��}râ��(h.jD��h/jÉ��ubaubhq)Årä��}rã��(h.U�h/j}��h0h1h2hth4}rå��(Ubulletrç��X���-h9]h8]h6]h7]h;]uh=K∫h>hh)]ré��(hw)Årè��}rê��(h.X<���the PID represents the snapshot, and snapshots are immutablerë��h/jä��h0h1h2h¢h4}rí��(h6]h7]h8]h9]h;]uh=Nh>hh)]rì��h|)Årî��}rï��(h.jë��h/jè��h0h1h2hãh4}rñ��(h6]h7]h8]h9]h;]uh=K∫h)]ró��hIX<���the PID represents the snapshot, and snapshots are immutablerò��ÖÅrô��}rö��(h.jë��h/jî��ubaubaubhw)Årõ��}rú��(h.XQ���the SID represents the entity, and can be applied to several connected snapshots.rù��h/jä��h0h1h2h¢h4}rû��(h6]h7]h8]h9]h;]uh=Nh>hh)]rü��h|)År†��}r°��(h.jù��h/jõ��h0h1h2hãh4}r¢��(h6]h7]h8]h9]h;]uh=Kªh)]r£��hIXQ���the SID represents the entity, and can be applied to several connected snapshots.r§��ÖÅr•��}r¶��(h.jù��h/j†��ubaubaubhw)Årß��}r®��(h.X ��A particular SID cannot be used if it is either reserved by or in use by someone else. * Specifically, the CN checks that the submitter has CHANGE_PERMISSION on the current head of the series * if not in use, checks submitter against ``cn.hasReservation(SID)`` * h/jä��h0Nh2h¢h4}r©��(h6]h7]h8]h9]h;]uh=Nh>hh)]r™��(h|)År´��}r¨��(h.XV���A particular SID cannot be used if it is either reserved by or in use by someone else.r≠��h/jß��h0h1h2hãh4}rÆ��(h6]h7]h8]h9]h;]uh=Kºh)]rØ��hIXV���A particular SID cannot be used if it is either reserved by or in use by someone else.r∞��ÖÅr±��}r≤��(h.j≠��h/j´��ubaubhq)År≥��}r¥��(h.U�h4}rµ��(jç��X���*h9]h8]h6]h7]h;]uh/jß��h)]r∂��(hw)År∑��}r∏��(h.Xf���Specifically, the CN checks that the submitter has CHANGE_PERMISSION on the current head of the seriesh4}rπ��(h6]h7]h8]h9]h;]uh/j≥��h)]r∫��h|)Årª��}rº��(h.Xf���Specifically, the CN checks that the submitter has CHANGE_PERMISSION on the current head of the seriesrΩ��h/j∑��h0h1h2hãh4}ræ��(h6]h7]h8]h9]h;]uh=Kæh)]rø��hIXf���Specifically, the CN checks that the submitter has CHANGE_PERMISSION on the current head of the seriesr¿��ÖÅr¡��}r¬��(h.jΩ��h/jª��ubaubah2h¢ubhw)År√��}rƒ��(h.XB���if not in use, checks submitter against ``cn.hasReservation(SID)``r≈��h4}r∆��(h6]h7]h8]h9]h;]uh/j≥��h)]r«��h|)År»��}r…��(h.j≈��h/j√��h0h1h2hãh4}r ��(h6]h7]h8]h9]h;]uh=K¿h)]rÀ��(hIX(���if not in use, checks submitter against rÃ��ÖÅrÕ��}rŒ��(h.X(���if not in use, checks submitter against h/j»��ubj£��)Årœ��}r–��(h.X���``cn.hasReservation(SID)``h4}r—��(h6]h7]h8]h9]h;]uh/j»��h)]r“��hIX���cn.hasReservation(SID)r”��ÖÅr‘��}r’��(h.U�h/jœ��ubah2j´��ubeubah2h¢ubhw)År÷��}r◊��(h.U�h4}rÿ��(h6]h7]h8]h9]h;]uh/j≥��h)]h2h¢ubeh2htubeubhw)ÅrŸ��}r⁄��(h.X2���cannot put SID in obsoletes and obsoletedBy fieldsr€��h/jä��h0h1h2h¢h4}r‹��(h6]h7]h8]h9]h;]uh=Nh>hh)]r›��h|)Årfi��}rfl��(h.j€��h/jŸ��h0h1h2hãh4}r‡��(h6]h7]h8]h9]h;]uh=K√h)]r·��hIX2���cannot put SID in obsoletes and obsoletedBy fieldsr‚��ÖÅr„��}r‰��(h.j€��h/jfi��ubaubaubhw)ÅrÂ��}rÊ��(h.Xl���SID resolution is "latest upload" among the set of snapshots not obsoleted by another member of the series. h/jä��h0h1h2h¢h4}rÁ��(h6]h7]h8]h9]h;]uh=Nh>hh)]rË��h|)ÅrÈ��}rÍ��(h.Xk���SID resolution is "latest upload" among the set of snapshots not obsoleted by another member of the series.rÎ��h/jÂ��h0h1h2hãh4}rÏ��(h6]h7]h8]h9]h;]uh=Kƒh)]rÌ��hIXk���SID resolution is "latest upload" among the set of snapshots not obsoleted by another member of the series.rÓ��ÖÅrÔ��}r��(h.jÎ��h/jÈ��ubaubaubhw)ÅrÒ��}rÚ��(h.Xˇ���not all revisions are guaranteed to be synchronized or replicated * is dependent on synchronization frequency, CN availability for sync * missing revisions, if synced but not replicated will appear as NotFound exceptions on forwarded resolve requests *h/jä��h0Nh2h¢h4}rÛ��(h6]h7]h8]h9]h;]uh=Nh>hh)]rÙ��(h|)Årı��}rˆ��(h.XA���not all revisions are guaranteed to be synchronized or replicatedr˜��h/jÒ��h0h1h2hãh4}r¯��(h6]h7]h8]h9]h;]uh=K«h)]r˘��hIXA���not all revisions are guaranteed to be synchronized or replicatedr˙��ÖÅr˚��}r¸��(h.j˜��h/jı��ubaubhq)År˝��}r˛��(h.U�h4}rˇ��(jç��X���*h9]h8]h6]h7]h;]uh/jÒ��h)]r���(hw)År��}r��(h.XC���is dependent on synchronization frequency, CN availability for syncr��h4}r��(h6]h7]h8]h9]h;]uh/j˝��h)]r��h|)År��}r��(h.j��h/j��h0h1h2hãh4}r��(h6]h7]h8]h9]h;]uh=K…h)]r ��hIXC���is dependent on synchronization frequency, CN availability for syncr ��ÖÅr��}r��(h.j��h/j��ubaubah2h¢ubhw)År ��}r��(h.Xp���missing revisions, if synced but not replicated will appear as NotFound exceptions on forwarded resolve requestsh4}r��(h6]h7]h8]h9]h;]uh/j˝��h)]r��h|)År��}r��(h.Xp���missing revisions, if synced but not replicated will appear as NotFound exceptions on forwarded resolve requestsr��h/j ��h0h1h2hãh4}r��(h6]h7]h8]h9]h;]uh=K h)]r��hIXp���missing revisions, if synced but not replicated will appear as NotFound exceptions on forwarded resolve requestsr��ÖÅr��}r��(h.j��h/j��ubaubah2h¢ubhw)År��}r��(h.U�h4}r��(h6]h7]h8]h9]h;]uh/j˝��h)]h2h¢ubeh2htubeubhw)År��}r��(h.XS���unsynchronized revisions might appear in obsoletes/dBy fields of existing revisionsr��h/jä��h0h1h2h¢h4}r��(h6]h7]h8]h9]h;]uh=Nh>hh)]r ��h|)År!��}r"��(h.j��h/j��h0h1h2hãh4}r#��(h6]h7]h8]h9]h;]uh=KÕh)]r$��hIXS���unsynchronized revisions might appear in obsoletes/dBy fields of existing revisionsr%��ÖÅr&��}r'��(h.j��h/j!��ubaubaubhw)År(��}r)��(h.XD���cn.listObjects(idFilter=sid)?? retrieves all synchronized revisions h/jä��h0h1h2h¢h4}r*��(h6]h7]h8]h9]h;]uh=Nh>hh)]r+��h|)År,��}r-��(h.XC���cn.listObjects(idFilter=sid)?? retrieves all synchronized revisionsr.��h/j(��h0h1h2hãh4}r/��(h6]h7]h8]h9]h;]uh=KŒh)]r0��hIXC���cn.listObjects(idFilter=sid)?? retrieves all synchronized revisionsr1��ÖÅr2��}r3��(h.j.��h/j,��ubaubaubhw)År4��}r5��(h.Xï���once SeriesID is set, it cannot be changed, because it breaks the trust that the identifier always gets the user to a conceptually equivalent object.h/jä��h0h1h2h¢h4}r6��(h6]h7]h8]h9]h;]uh=Nh>hh)]r7��h|)År8��}r9��(h.Xï���once SeriesID is set, it cannot be changed, because it breaks the trust that the identifier always gets the user to a conceptually equivalent object.r:��h/j4��h0h1h2hãh4}r;��(h6]h7]h8]h9]h;]uh=K–h)]r<��hIXï���once SeriesID is set, it cannot be changed, because it breaks the trust that the identifier always gets the user to a conceptually equivalent object.r=��ÖÅr>��}r?��(h.j:��h/j8��ubaubaubeubeubeh.U�Utransformerr@��NU footnote_refsrA��}rB��UrefnamesrC��}rD��Usymbol_footnotesrE��]rF��Uautofootnote_refsrG��]rH��Usymbol_footnote_refsrI��]rJ��U citationsrK��]rL��h>hUcurrent_linerM��NUtransform_messagesrN��]rO��cdocutils.nodes system_message rP��)ÅrQ��}rR��(h.U�h4}rS��(h6]UlevelKh9]h8]Usourceh1h7]h;]UlineKUtypeUINFOrT��uh)]rU��h|)ÅrV��}rW��(h.U�h4}rX��(h6]h7]h8]h9]h;]uh/jQ��h)]rY��hIX-���Hyperlink target "index-0" is not referenced.rZ��ÖÅr[��}r\��(h.U�h/jV��ubah2hãubah2Usystem_messager]��ubaUreporterr^��NUid_startr_��KU autofootnotesr`��]ra��U citation_refsrb��}rc��Uindirect_targetsrd��]re��Usettingsrf��(cdocutils.frontend Values rg��orh��}ri��(Ufootnote_backlinksrj��KUrecord_dependenciesrk��NUrfc_base_urlrl��Uhttps://tools.ietf.org/html/rm��U tracebackrn��àUpep_referencesro��NUstrip_commentsrp��NU toc_backlinksrq��Uentryrr��U language_coders��Uenrt��U datestampru��NUreport_levelrv��KU_destinationrw��NU halt_levelrx��KU strip_classesry��NhDNUerror_encoding_error_handlerrz��Ubackslashreplacer{��Udebugr|��NUembed_stylesheetr}��âUoutput_encoding_error_handlerr~��Ustrictr��U sectnum_xformrÄ��KUdump_transformsrÅ��NU docinfo_xformrÇ��KUwarning_streamrÉ��NUpep_file_url_templaterÑ��Upep-%04drÖ��Uexit_status_levelrÜ��KUconfigrá��NUstrict_visitorrà��NUcloak_email_addressesrâ��àUtrim_footnote_reference_spacerä��âUenvrã��NUdump_pseudo_xmlrå��NUexpose_internalsrç��NUsectsubtitle_xformré��âUsource_linkrè��NUrfc_referencesrê��NUoutput_encodingrë��Uutf-8rí��U source_urlrì��NUinput_encodingrî��U utf-8-sigrï��U_disable_configrñ��NU id_prefixró��U�U tab_widthrò��KUerror_encodingrô��UUTF-8rö��U_sourcerõ��h1Ugettext_compactrú��àU generatorrù��NUdump_internalsrû��NUsmart_quotesrü��âUpep_base_urlr†��U https://www.python.org/dev/peps/r°��Usyntax_highlightr¢��Ulongr£��Uinput_encoding_error_handlerr§��j��Uauto_id_prefixr•��Uidr¶��Udoctitle_xformrß��âUstrip_elements_with_classesr®��NU _config_filesr©��]Ufile_insertion_enabledr™��àUraw_enabledr´��KU dump_settingsr¨��NubUsymbol_footnote_startr≠��K�UidsrÆ��}rØ��(h jE��h%h,h(h^hj©��j ��j��j��j��hÂh·h˜hÛh¡hΩh”hœhúhòhØh´hGhÇj-��j)��j?��j;��h$jJ��h"jfl��hUh^hjb��hjp��h!j,��h'jÚ��h#j��h&j}��hj›��uUsubstitution_namesr∞��}r±��h2h>h4}r≤��(h6]h9]h8]Usourceh1h7]h;]uU footnotesr≥��]r¥��Urefidsrµ��}r∂��hU]r∑��hYasub.