€cdocutils.nodes document q)q}q(U nametypesq}q(Xquerying the indexqNXregenerating the indexqNXaccess policy enforcementqNX+adding additional document types and fieldsq NXdefault indexed fieldsq NXclass design overviewq NXindex configurationq NXindexed documents and fieldsq NXmetacat indexingqNuUsubstitution_defsq}qUparse_messagesq]qUcurrent_sourceqNU decorationqNUautofootnote_startqKUnameidsq}q(hUquerying-the-indexqhUregenerating-the-indexqhUaccess-policy-enforcementqh U+adding-additional-document-types-and-fieldsqh Udefault-indexed-fieldsqh Uclass-design-overviewqh Uindex-configurationqh Uindexed-documents-and-fieldsqhUmetacat-indexingq uUchildrenq!]q"(cdocutils.nodes raw q#)q$}q%(U rawsourceq&X\newpageUparentq'hUsourceq(XY/var/lib/jenkins/jobs/metacat-unstable/workspace/docs/user/metacat/source/query-index.rstq)Utagnameq*Urawq+U attributesq,}q-(UformatXlatexU xml:spaceq.Upreserveq/Uidsq0]Ubackrefsq1]Udupnamesq2]Uclassesq3]Unamesq4]uUlineq5KUdocumentq6hh!]q7cdocutils.nodes Text q8X\newpageq9…q:}q;(h&Uh'h$ubaubcdocutils.nodes section q<)q=}q>(h&Uh'hh(h)h*Usectionq?h,}q@(h2]h3]h1]h0]qAh ah4]qBhauh5Kh6hh!]qC(cdocutils.nodes title qD)qE}qF(h&XMetacat IndexingqGh'h=h(h)h*UtitleqHh,}qI(h2]h3]h1]h0]h4]uh5Kh6hh!]qJh8XMetacat IndexingqK…qL}qM(h&hGh'hEubaubcdocutils.nodes paragraph qN)qO}qP(h&XÙMetacat v2.1 introduces support for building a SOLR index of Metacat content. While we continue to support the "pathquery" search mechanism, this will be phased out in favor of the more efficient SOLR query interface.qQh'h=h(h)h*U paragraphqRh,}qS(h2]h3]h1]h0]h4]uh5Kh6hh!]qTh8XÙMetacat v2.1 introduces support for building a SOLR index of Metacat content. While we continue to support the "pathquery" search mechanism, this will be phased out in favor of the more efficient SOLR query interface.qU…qV}qW(h&hQh'hOubaubhN)qX}qY(h&X]Metacat deployments that opt to use the Metacat SOLR index will be able to take advantage of:qZh'h=h(h)h*hRh,}q[(h2]h3]h1]h0]h4]uh5K h6hh!]q\h8X]Metacat deployments that opt to use the Metacat SOLR index will be able to take advantage of:q]…q^}q_(h&hZh'hXubaubcdocutils.nodes bullet_list q`)qa}qb(h&Uh'h=h(h)h*U bullet_listqch,}qd(UbulletqeX*h0]h1]h2]h3]h4]uh5Kh6hh!]qf(cdocutils.nodes list_item qg)qh}qi(h&Xfast search performanceqjh'hah(h)h*U list_itemqkh,}ql(h2]h3]h1]h0]h4]uh5Nh6hh!]qmhN)qn}qo(h&hjh'hhh(h)h*hRh,}qp(h2]h3]h1]h0]h4]uh5Kh!]qqh8Xfast search performanceqr…qs}qt(h&hjh'hnubaubaubhg)qu}qv(h&Xbuilt-in paging featuresqwh'hah(h)h*hkh,}qx(h2]h3]h1]h0]h4]uh5Nh6hh!]qyhN)qz}q{(h&hwh'huh(h)h*hRh,}q|(h2]h3]h1]h0]h4]uh5Kh!]q}h8Xbuilt-in paging featuresq~…q}q€(h&hwh'hzubaubaubhg)q}q‚(h&X2customizable return formats (for advanced admins) h'hah(h)h*hkh,}qƒ(h2]h3]h1]h0]h4]uh5Nh6hh!]q„hN)q…}q†(h&X1customizable return formats (for advanced admins)q‡h'hh(h)h*hRh,}qˆ(h2]h3]h1]h0]h4]uh5Kh!]q‰h8X1customizable return formats (for advanced admins)qŠ…q‹}qŒ(h&h‡h'h…ubaubaubeubh<)q}qŽ(h&Uh'h=h(h)h*h?h,}q(h2]h3]h1]h0]qhah4]q‘h auh5Kh6hh!]q’(hD)q“}q”(h&XIndexed documents and fieldsq•h'hh(h)h*hHh,}q–(h2]h3]h1]h0]h4]uh5Kh6hh!]q—h8XIndexed documents and fieldsq˜…q™}qš(h&h•h'h“ubaubhN)q›}qœ(h&XqMetacat integrates the existing DataONE index library which includes many common metadata formats out-of-the-box:qh'hh(h)h*hRh,}qž(h2]h3]h1]h0]h4]uh5Kh6hh!]qŸh8XqMetacat integrates the existing DataONE index library which includes many common metadata formats out-of-the-box:q …q¡}q¢(h&hh'h›ubaubcdocutils.nodes enumerated_list q£)q¤}q¥(h&Uh'hh(h)h*Uenumerated_listq¦h,}q§(Usuffixq¨U.h0]h1]h2]Uprefixq©Uh3]h4]UenumtypeqªUarabicq«uh5Kh6hh!]q¬(hg)q­}q®(h&XEMLq¯h'h¤h(h)h*hkh,}q°(h2]h3]h1]h0]h4]uh5Nh6hh!]q±hN)q²}q³(h&h¯h'h­h(h)h*hRh,}q´(h2]h3]h1]h0]h4]uh5Kh!]qµh8XEMLq¶…q·}q¸(h&h¯h'h²ubaubaubhg)q¹}qº(h&XFGDCq»h'h¤h(h)h*hkh,}q¼(h2]h3]h1]h0]h4]uh5Nh6hh!]q½hN)q¾}q¿(h&h»h'h¹h(h)h*hRh,}qÀ(h2]h3]h1]h0]h4]uh5Kh!]qÁh8XFGDCqÂ…qÃ}qÄ(h&h»h'h¾ubaubaubhg)qÅ}qÆ(h&XDryad* h'h¤h(h)h*hkh,}qÇ(h2]h3]h1]h0]h4]uh5Nh6hh!]qÈhN)qÉ}qÊ(h&XDryad*qËh'hÅh(h)h*hRh,}qÌ(h2]h3]h1]h0]h4]uh5Kh!]qÍh8XDryad*qÎ…qÏ}qÐ(h&hËh'hÉubaubaubeubeubh<)qÑ}qÒ(h&Uh'h=h(h)h*h?h,}qÓ(h2]h3]h1]h0]qÔhah4]qÕh auh5Kh6hh!]qÖ(hD)q×}qØ(h&XDefault indexed fieldsqÙh'hÑh(h)h*hHh,}qÚ(h2]h3]h1]h0]h4]uh5Kh6hh!]qÛh8XDefault indexed fieldsqÜ…qÝ}qÞ(h&hÙh'h×ubaubhN)qß}qà(h&XSFor a complete listing of the indexed fields, please see the DataONE documentation.qáh'hÑh(h)h*hRh,}qâ(h2]h3]h1]h0]h4]uh5K h6hh!]qãh8XSFor a complete listing of the indexed fields, please see the DataONE documentation.qä…qå}qæ(h&háh'hßubaubhN)qç}qè(h&XLhttp://mule1.dataone.org/ArchitectureDocs-current/design/SearchMetadata.htmlqéh'hÑh(h)h*hRh,}qê(h2]h3]h1]h0]h4]uh5K"h6hh!]qëcdocutils.nodes reference qì)qí}qî(h&héh,}qï(Urefurihéh0]h1]h2]h3]h4]uh'hçh!]qðh8XLhttp://mule1.dataone.org/ArchitectureDocs-current/design/SearchMetadata.htmlqñ…qò}qó(h&Uh'híubah*U referenceqôubaubhN)qõ}qö(h&XIMetacat also reports on the currently-indexed fields, simply navigate to:q÷h'hÑh(h)h*hRh,}qø(h2]h3]h1]h0]h4]uh5K$h6hh!]qùh8XIMetacat also reports on the currently-indexed fields, simply navigate to:qú…qû}qü(h&h÷h'hõubaubhN)qý}qþ(h&Xehttp://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MNQuery.getQueryEngineDescriptionqÿh'hÑh(h)h*hRh,}r(h2]h3]h1]h0]h4]uh5K&h6hh!]rhì)r}r(h&hÿh,}r(Urefurihÿh0]h1]h2]h3]h4]uh'hýh!]rh8Xehttp://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MNQuery.getQueryEngineDescriptionr…r}r(h&Uh'jubah*hôubaubhN)r }r (h&Xwith "solr" as the engine.r h'hÑh(h)h*hRh,}r (h2]h3]h1]h0]h4]uh5K(h6hh!]r h8Xwith "solr" as the engine.r…r}r(h&j h'j ubaubeubh<)r}r(h&Uh'h=h(h)h*h?h,}r(h2]h3]h1]h0]rhah4]rh auh5K+h6hh!]r(hD)r}r(h&XIndex configurationrh'jh(h)h*hHh,}r(h2]h3]h1]h0]h4]uh5K+h6hh!]rh8XIndex configurationr…r}r(h&jh'jubaubhN)r}r (h&XKMetacat-index is deployed as a separate web application (metacat-index.war) and should be deployed as a sibling of the Metacat webapp (metacat.war). Deploying metacat-index.war is only required when SOLR support is desired (e.g., for MetacatUI) and can safely be omitted if it will not be utilized for any given Metacat deployment.r!h'jh(h)h*hRh,}r"(h2]h3]h1]h0]h4]uh5K,h6hh!]r#h8XKMetacat-index is deployed as a separate web application (metacat-index.war) and should be deployed as a sibling of the Metacat webapp (metacat.war). Deploying metacat-index.war is only required when SOLR support is desired (e.g., for MetacatUI) and can safely be omitted if it will not be utilized for any given Metacat deployment.r$…r%}r&(h&j!h'jubaubhN)r'}r((h&X’During the initial installation/upgrade, an empty index will be initialized in the configured "solr-home" location. Metacat-index will index all the existing Metacat content when the webapp next initializes. Note: the configured solr-home directory should not exist before configuring Metacat with indexing for the first time, otherwise the blank index will not be created for metacat-index to utilize.r)h'jh(h)h*hRh,}r*(h2]h3]h1]h0]h4]uh5K1h6hh!]r+h8X’During the initial installation/upgrade, an empty index will be initialized in the configured "solr-home" location. Metacat-index will index all the existing Metacat content when the webapp next initializes. Note: the configured solr-home directory should not exist before configuring Metacat with indexing for the first time, otherwise the blank index will not be created for metacat-index to utilize.r,…r-}r.(h&j)h'j'ubaubhN)r/}r0(h&X‚Additional advanced configuration options are available in the metacat.properties file (shared between Metacat and Metacat-index).r1h'jh(h)h*hRh,}r2(h2]h3]h1]h0]h4]uh5K6h6hh!]r3h8X‚Additional advanced configuration options are available in the metacat.properties file (shared between Metacat and Metacat-index).r4…r5}r6(h&j1h'j/ubaubeubh<)r7}r8(h&Uh'h=h(h)h*h?h,}r9(h2]h3]h1]h0]r:hah4]r;h auh5K:h6hh!]r<(hD)r=}r>(h&X+Adding additional document types and fieldsr?h'j7h(h)h*hHh,}r@(h2]h3]h1]h0]h4]uh5K:h6hh!]rAh8X+Adding additional document types and fieldsrB…rC}rD(h&j?h'j=ubaubhN)rE}rF(h&XDTBD: Step-by-step guide for adding new documents and indexed fields.rGh'j7h(h)h*hRh,}rH(h2]h3]h1]h0]h4]uh5K;h6hh!]rIh8XDTBD: Step-by-step guide for adding new documents and indexed fields.rJ…rK}rL(h&jGh'jEubaubeubh<)rM}rN(h&Uh'h=h(h)h*h?h,}rO(h2]h3]h1]h0]rPhah4]rQhauh5K?h6hh!]rR(hD)rS}rT(h&XQuerying the indexrUh'jMh(h)h*hHh,}rV(h2]h3]h1]h0]h4]uh5K?h6hh!]rWh8XQuerying the indexrX…rY}rZ(h&jUh'jSubaubhN)r[}r\(h&X‡The SOLR index can be queried using standard SOLR syntax and return options. The DataONE query interface exposes the SOLR query engine.r]h'jMh(h)h*hRh,}r^(h2]h3]h1]h0]h4]uh5K@h6hh!]r_h8X‡The SOLR index can be queried using standard SOLR syntax and return options. The DataONE query interface exposes the SOLR query engine.r`…ra}rb(h&j]h'j[ubaubhN)rc}rd(h&XQhttp://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MNQuery.queryreh'jMh(h)h*hRh,}rf(h2]h3]h1]h0]h4]uh5KCh6hh!]rghì)rh}ri(h&jeh,}rj(Urefurijeh0]h1]h2]h3]h4]uh'jch!]rkh8XQhttp://mule1.dataone.org/ArchitectureDocs-current/apis/MN_APIs.html#MNQuery.queryrl…rm}rn(h&Uh'jhubah*hôubaubhN)ro}rp(h&XQPlease see the SOLR documentation for examples and exhaustive syntax information.rqh'jMh(h)h*hRh,}rr(h2]h3]h1]h0]h4]uh5KEh6hh!]rsh8XQPlease see the SOLR documentation for examples and exhaustive syntax information.rt…ru}rv(h&jqh'joubaubhN)rw}rx(h&Xhttp://lucene.apache.org/solr/ryh'jMh(h)h*hRh,}rz(h2]h3]h1]h0]h4]uh5KGh6hh!]r{hì)r|}r}(h&jyh,}r~(Urefurijyh0]h1]h2]h3]h4]uh'jwh!]rh8Xhttp://lucene.apache.org/solr/r€…r}r‚(h&Uh'j|ubah*hôubaubeubh<)rƒ}r„(h&Uh'h=h(h)h*h?h,}r…(h2]h3]h1]h0]r†hah4]r‡hauh5KKh6hh!]rˆ(hD)r‰}rŠ(h&XAccess Policy enforcementr‹h'jƒh(h)h*hHh,}rŒ(h2]h3]h1]h0]h4]uh5KKh6hh!]rh8XAccess Policy enforcementrŽ…r}r(h&j‹h'j‰ubaubhN)r‘}r’(h&X‰Access control is enforced by the index such that only records that are readable by the user performing the query are returned to the user. Any SOLR query submitted will be augmented with access control criteria corresponding to if and how the user is currently authenticated. Both certificate-based (DataONE API) and JSESSIONID-based (Metacat API) authentication are simultaneously supported.r“h'jƒh(h)h*hRh,}r”(h2]h3]h1]h0]h4]uh5KLh6hh!]r•h8X‰Access control is enforced by the index such that only records that are readable by the user performing the query are returned to the user. Any SOLR query submitted will be augmented with access control criteria corresponding to if and how the user is currently authenticated. Both certificate-based (DataONE API) and JSESSIONID-based (Metacat API) authentication are simultaneously supported.r–…r—}r˜(h&j“h'j‘ubaubeubh<)r™}rš(h&Uh'h=h(h)h*h?h,}r›(h2]h3]h1]h0]rœhah4]rhauh5KTh6hh!]rž(hD)rŸ}r (h&XRegenerating the indexr¡h'j™h(h)h*hHh,}r¢(h2]h3]h1]h0]h4]uh5KTh6hh!]r£h8XRegenerating the indexr¤…r¥}r¦(h&j¡h'jŸubaubhN)r§}r¨(h&X†When the SOLR index has been drastically modified, a complete regeneration of the index may be necessary. In order to accomplish this:r©h'j™h(h)h*hRh,}rª(h2]h3]h1]h0]h4]uh5KUh6hh!]r«h8X†When the SOLR index has been drastically modified, a complete regeneration of the index may be necessary. In order to accomplish this:r¬…r­}r®(h&j©h'j§ubaubh£)r¯}r°(h&Uh'j™h(h)h*h¦h,}r±(h¨U.h0]h1]h2]h©Uh3]h4]hªh«uh5KXh6hh!]r²(hg)r³}r´(h&X"Login as the Metacat administratorrµh'j¯h(h)h*hkh,}r¶(h2]h3]h1]h0]h4]uh5Nh6hh!]r·hN)r¸}r¹(h&jµh'j³h(h)h*hRh,}rº(h2]h3]h1]h0]h4]uh5KXh!]r»h8X"Login as the Metacat administratorr¼…r½}r¾(h&jµh'j¸ubaubaubhg)r¿}rÀ(h&XBNavigate to: //metacat?action=reindexall h'j¯h(h)h*hkh,}rÁ(h2]h3]h1]h0]h4]uh5Nh6hh!]rÂhN)rÃ}rÄ(h&X?Navigate to: //metacat?action=reindexallrÅh'j¿h(h)h*hRh,}rÆ(h2]h3]h1]h0]h4]uh5KYh!]rÇh8X?Navigate to: //metacat?action=reindexallrÈ…rÉ}rÊ(h&jÅh'jÃubaubaubeubeubh<)rË}rÌ(h&Uh'h=h(h)h*h?h,}rÍ(h2]h3]h1]h0]rÎhah4]rÏh auh5K^h6hh!]rÐ(hD)rÑ}rÒ(h&XClass design overviewrÓh'jËh(h)h*hHh,}rÔ(h2]h3]h1]h0]h4]uh5K^h6hh!]rÕh8XClass design overviewrÖ…r×}rØ(h&jÓh'jÑubaubcdocutils.nodes figure rÙ)rÚ}rÛ(h&Uh'jËh(h)h*UfigurerÜh,}rÝ(h2]h3]h1]h0]rÞUid1rßah4]uh5Nh6hh!]rà(cdocutils.nodes image rá)râ}rã(h&XS.. figure:: images/indexing-class-diagram.png Figure 1. Class design overview. h,}rä(UuriX!images/indexing-class-diagram.pngråh0]h1]h2]h3]U candidatesræ}rçU*jåsh4]uh'jÚh!]h*Uimagerèubcdocutils.nodes caption ré)rê}rë(h&X Figure 1. Class design overview.rìh'jÚh(h)h*Ucaptionríh,}rî(h2]h3]h1]h0]h4]uh5Kbh!]rïh8X Figure 1. Class design overview.rð…rñ}rò(h&jìh'jêubaubeubcdocutils.nodes comment ró)rô}rõ(h&Xu@startuml images/indexing-class-diagram.png package "Current cn-index-processor (library)" { interface IDocumentSubprocessor { + boolean canProcess(Document doc) + initExpression(XPath xpath) + Map processDocument(String identifier, Map docs, Document doc) } class AbstractDocumentSubprocessor { - List fields + setMatchDocument(String matchDocument) + setFieldList(List fieldList) } class ResourceMapSubprocessor { } class ScienceMetadataDocumentSubprocessor { } interface ISolrField { + initExpression(XPath xpathObject) + List getFields(Document doc, String identifier) } class SolrField { - String name - String xpath - boolean multivalue } class CommonRootSolrField { } class RootElement { } class LeafElement { } class FullTextSolrField { } class MergeSolrField { } class ResolveSolrField { } class SolrFieldResourceMap { } class SolrDoc { - List fieldList } class SolrElementField { - String name - String value } } IDocumentSubprocessor <|-- AbstractDocumentSubprocessor AbstractDocumentSubprocessor <|-- ResourceMapSubprocessor AbstractDocumentSubprocessor <|-- ScienceMetadataDocumentSubprocessor ISolrField <|-- SolrField SolrField <|-- CommonRootSolrField CommonRootSolrField o--"1" RootElement RootElement o--"*" LeafElement SolrField <|-- FullTextSolrField SolrField <|-- MergeSolrField SolrField <|-- ResolveSolrField SolrField <|-- SolrFieldResourceMap AbstractDocumentSubprocessor o--"*" ISolrField IDocumentSubprocessor --> SolrDoc SolrDoc o--"*" SolrElementField package "SOLR (library)" { abstract class SolrServer { + add(SolrInputDocument doc) + deleteByQuery(String id) + query(SolrQuery query) } class EmbeddedSolrServer { } class HttpSolrServer { } } SolrServer <|-- EmbeddedSolrServer SolrServer <|-- HttpSolrServer package "Metact-index (webapp)" { class ApplicationController { - List solrIndex + regenerateIndex() } class SolrIndex { - List subprocessors - SolrServer solrServer + insert(String pid, InputStream data) + update(String pid, InputStream data) + remove(String pid) } class SystemMetadataEventListener { - SolrIndex solrIndex + itemAdded(ItemEvent) + itemRemoved(ItemEvent) } } package "Metacat (webapp)" { class MetacatSolrIndex { - SolrServer solrServer + InputStream query(SolrQuery) } class HazelcastService { - IMap hzIndexQueue - IMap hzSystemMetadata - IMap hzObjectPath } } MetacatSolrIndex o--"1" SolrServer HazelcastService .. SystemMetadataEventListener ApplicationController o--"*" SolrIndex SolrIndex o--"1" SolrServer SolrIndex "1"--o SystemMetadataEventListener SolrIndex o--"*" IDocumentSubprocessor: Assembled using Spring bean configuration @endumlh'jËh(h)h*Ucommentröh,}r÷(h.h/h0]h1]h2]h3]h4]uh5Kðh6hh!]røh8Xu@startuml images/indexing-class-diagram.png package "Current cn-index-processor (library)" { interface IDocumentSubprocessor { + boolean canProcess(Document doc) + initExpression(XPath xpath) + Map processDocument(String identifier, Map docs, Document doc) } class AbstractDocumentSubprocessor { - List fields + setMatchDocument(String matchDocument) + setFieldList(List fieldList) } class ResourceMapSubprocessor { } class ScienceMetadataDocumentSubprocessor { } interface ISolrField { + initExpression(XPath xpathObject) + List getFields(Document doc, String identifier) } class SolrField { - String name - String xpath - boolean multivalue } class CommonRootSolrField { } class RootElement { } class LeafElement { } class FullTextSolrField { } class MergeSolrField { } class ResolveSolrField { } class SolrFieldResourceMap { } class SolrDoc { - List fieldList } class SolrElementField { - String name - String value } } IDocumentSubprocessor <|-- AbstractDocumentSubprocessor AbstractDocumentSubprocessor <|-- ResourceMapSubprocessor AbstractDocumentSubprocessor <|-- ScienceMetadataDocumentSubprocessor ISolrField <|-- SolrField SolrField <|-- CommonRootSolrField CommonRootSolrField o--"1" RootElement RootElement o--"*" LeafElement SolrField <|-- FullTextSolrField SolrField <|-- MergeSolrField SolrField <|-- ResolveSolrField SolrField <|-- SolrFieldResourceMap AbstractDocumentSubprocessor o--"*" ISolrField IDocumentSubprocessor --> SolrDoc SolrDoc o--"*" SolrElementField package "SOLR (library)" { abstract class SolrServer { + add(SolrInputDocument doc) + deleteByQuery(String id) + query(SolrQuery query) } class EmbeddedSolrServer { } class HttpSolrServer { } } SolrServer <|-- EmbeddedSolrServer SolrServer <|-- HttpSolrServer package "Metact-index (webapp)" { class ApplicationController { - List solrIndex + regenerateIndex() } class SolrIndex { - List subprocessors - SolrServer solrServer + insert(String pid, InputStream data) + update(String pid, InputStream data) + remove(String pid) } class SystemMetadataEventListener { - SolrIndex solrIndex + itemAdded(ItemEvent) + itemRemoved(ItemEvent) } } package "Metacat (webapp)" { class MetacatSolrIndex { - SolrServer solrServer + InputStream query(SolrQuery) } class HazelcastService { - IMap hzIndexQueue - IMap hzSystemMetadata - IMap hzObjectPath } } MetacatSolrIndex o--"1" SolrServer HazelcastService .. SystemMetadataEventListener ApplicationController o--"*" SolrIndex SolrIndex o--"1" SolrServer SolrIndex "1"--o SystemMetadataEventListener SolrIndex o--"*" IDocumentSubprocessor: Assembled using Spring bean configuration @endumlrù…rú}rû(h&Uh'jôubaubeubeubeh&UU transformerrüNU footnote_refsrý}rþUrefnamesrÿ}rUsymbol_footnotesr]rUautofootnote_refsr]rUsymbol_footnote_refsr]rU citationsr]rh6hU current_liner NUtransform_messagesr ]r Ureporterr NUid_startr KU autofootnotesr]rU citation_refsr}rUindirect_targetsr]rUsettingsr(cdocutils.frontend Values ror}r(Ufootnote_backlinksrKUrecord_dependenciesrNU rfc_base_urlrUhttps://tools.ietf.org/html/rU tracebackrˆUpep_referencesrNUstrip_commentsrNU toc_backlinksrUentryr U language_coder!Uenr"U datestampr#NU report_levelr$KU _destinationr%NU halt_levelr&KU strip_classesr'NhHNUerror_encoding_error_handlerr(Ubackslashreplacer)Udebugr*NUembed_stylesheetr+‰Uoutput_encoding_error_handlerr,Ustrictr-U sectnum_xformr.KUdump_transformsr/NU docinfo_xformr0KUwarning_streamr1NUpep_file_url_templater2Upep-%04dr3Uexit_status_levelr4KUconfigr5NUstrict_visitorr6NUcloak_email_addressesr7ˆUtrim_footnote_reference_spacer8‰Uenvr9NUdump_pseudo_xmlr:NUexpose_internalsr;NUsectsubtitle_xformr<‰U source_linkr=NUrfc_referencesr>NUoutput_encodingr?Uutf-8r@U source_urlrANUinput_encodingrBU utf-8-sigrCU_disable_configrDNU id_prefixrEUU tab_widthrFKUerror_encodingrGUUTF-8rHU_sourcerIh)Ugettext_compactrJˆU generatorrKNUdump_internalsrLNU smart_quotesrM‰U pep_base_urlrNU https://www.python.org/dev/peps/rOUsyntax_highlightrPUlongrQUinput_encoding_error_handlerrRj-Uauto_id_prefixrSUidrTUdoctitle_xformrU‰Ustrip_elements_with_classesrVNU _config_filesrW]Ufile_insertion_enabledrXˆU raw_enabledrYKU dump_settingsrZNubUsymbol_footnote_startr[Kh0}r\(hhhjËhj7hhÑh h=jßjÚhj™hjMhjƒhjuUsubstitution_namesr]}r^h*h6h,}r_(h2]h0]h1]Usourceh)h3]h4]uU footnotesr`]raUrefidsrb}rcub.