.. _TemplateManual: DPDD User Manual Template ========================= Keywords List _______________ .. code-block:: rst :caption: Commands: Keywords $SetSchemaPath $PrintDataProductName $PrintDataProductCustodian $PrintSchemaFilename $PrintDataProductElements $PrintCatalog $PrintPrimaryHeader $PrintExtensionHeader $PrintHDUTableContents The specific set of keywords shown above represent the set of commands created for the user. As can be observed every command will start with "$". Set the Schema Path ____________________ .. code-block:: rst :caption: Commands: Set the Schema Path $SetSchemaPath le3/wl/inp/euc-test-le3-wl-InputLE2Catalog.xsd This command sets the path to the corresponding Data Model product and allows information to be retrieved automatically. This command is positioned after the title of the document. The information that we are able to retrieve is the Name of the Data Product, the Data Product Custodians, the Name of the Schema and Data Product Elements. Data Product name ___________________ .. code-block:: rst :caption: Commands: Present Name of the Data Product $PrintDataProductName Retrieve the current Name of the Data Product used within the Data Model. The Data Product Name adheres to the Euclid Data Model naming conventions. Data Product Custodian ______________________ .. code-block:: rst :caption: Commands: Present the Formal Teams in charge of the Data Product $PrintDataProductCustodian This command will display the current custodian(s) for the Data Product. Name of the Schema File ________________________ .. code-block:: rst :caption: Commands: Name of the XSD Schema File. Link GitLab. $PrintSchemaFilename This command will display the name of the XSD file for the Data Product and provide a link to the corresponding file in the Data Model. Data Product elements ______________________ .. code-block:: rst :caption: Commands: Attributes "Name" and "type" of tree elements for the Data Product $PrintDataProductElements This command will display the Data Product elements, such as the Headers, Data, Quality Flags and Parameters. Detailed description of the data product _________________________________________ .. DetailedDescStart **Previous Information** The Following commands are normally included within this section. Print Catalog ~~~~~~~~~~~~~~ .. code-block:: rst :caption: Commands: Table with Column, Name, and Description $PrintCatalog fit/euc-test-le3-wl.xml le3.wl.input.le2catalog This command prints the content of a FITS catalogue within a table in an organised manner. This is optional but highly recommended. .. _PrintCatalog: .. figure:: images/PrintCatalog.png :scale: 40 % :align: center :figclass: align-center : Syntax of command print catalog When to use it ? Use it to print tables that emphasize to show the content within Column Lists. Design of table Column Name, Description and Unit. Primary Header ~~~~~~~~~~~~~~~ .. code-block:: rst :caption: Commands: Table $PrintPrimaryHeader fit/euc-test-le1-vis.xml le1.visRawImage This command prints the content of a FITS catalogue within a table in an organised manner. This is optional but highly recommended. .. _Primary: .. figure:: images/Primary.png :scale: 35 % :align: center :figclass: align-center : Sintax of command Print Primary Header When to use it ? Use it to print tables that emphasize to show the content of Primary Header. Design of table Name, if Fixed exists it creates a table or not and Description. Extension Header ~~~~~~~~~~~~~~~~~ .. code-block:: rst :caption: Commands: Table $PrintExtensionHeader fit/euc-test-le1-vis.xml le1.visRawImage SCI.n This command allow developers to bring the FitsFormat or FitsFiles within a table in an organized manner. Is highly recommended its use. .. _Extension: .. figure:: images/Extension.png :scale: 35 % :align: center :figclass: align-center : Sintax of command Print Extension Header When to use it ? Use it to print tables that emphasize to show the content of any Extension Header. Design of table Name, if Fixed exists it creates a table or not and Description. HDU Table ~~~~~~~~~~ .. code-block:: rst :caption: Commands: Table $PrintHDUTableContents fit/euc-test-le3-gc.xml le3.gc.bkpf.spe.mono BISPECTRUM This command allow developers to bring the FitsFormat or FitsFiles within a table in an organized manner. Is highly recommended its use. .. _HDU: .. figure:: images/HDU.png :scale: 35 % :align: center :figclass: align-center : Sintax of command Print HDU Table Contents When to use it ? Use it to print tables that emphasize to show at the same time the content of any Extension Header and Column List. Design of table Is a combination divided in two sections, keywords and Columns List: - For keywords name, if Fixed exist and Description. - For Columns Name, Description, Format and Unit Required Stucture for Documentation ____________________________________ This is the **required** content structure that developers shall provide for data product. .. code-block:: rst :caption: Commands: Minimal content /** * ├──Title * ├── Data product name * ├── Data product custodian * ├── Name of the Schema file * ├── Last Edited for DPDD version * ├── Processing elements creating / updating / using the product * ├── Processing function using the product * ├── Proposed for inclusion in EAS/SAS * ├── Data product elements * └── Data product detailed description */ These are some additional titles used by some products. Examples ________ This example shows the output obtained by using the command PrintCatalog for data-product-doc/ST_FitsDataModel/ST_DM_FitsSchema/auxdir/ST_DM_FitsSchema/instances/fit/euc-test-le3-wl.xml with the FitsFormat id le3.wl.input.le2catalog. .. raw:: html Example for 2dmasswl_shearcatalog.rst using the command PrintCatalog This example shows the output obtained by using the command PrintPrimaryHeader and PrintExtensionHeader for data-product-doc/ST_FitsDataModel/ST_DM_FitsSchema/auxdir/ST_DM_FitsSchema/instances/fit/euc-test-le1-vis.xml with the fits format le1.visRawImage and in the case of Extension Header we need to include the ArrayHDU attribute name SCI.n . .. raw:: html Example for le1_visrawframe.rst using the command PrintPrimaryHeader and PrintExtensionHeader This example shows the output obtained by using the command PrintHDUTableContents for data-product-doc/ST_FitsDataModel/ST_DM_FitsSchema/auxdir/ST_DM_FitsSchema/instances/fit/euc-test-le3-gc.xml with the FitsFormat id le3.gc.bkpf.spe.mono and in addition is needed to specify the the attribute name of TableHDU as for this scenario BISPECTRUM and SPECTRUM. .. raw:: html Example for bkgc_OUTPUT_spe_mono.rst using the command PrintHDUTableContents .. DetailedDescEnd