nxsconfigserver


Namenxsconfigserver JSON
Version 2.15.0 PyPI version JSON
download
home_pagehttp://github.com/jkotan/nexdatas/nxsconfigserver
SummaryConfiguration Server for Nexus Data Writer
upload_time2023-11-10 13:15:10
maintainer
docs_urlNone
authorJan Kotanski, Eugen Wintersberger , Halil Pasic
requires_python
licenseGNU GENERAL PUBLIC LICENSE v3
keywords configuration mysql writer tango server nexus data
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ======================================================
Welcome to NeXuS Configuration Server's documentation!
======================================================

|github workflow|
|docs|
|Pypi Version|
|Python Versions|

.. |github workflow| image:: https://github.com/nexdatas/nxsconfigserver/actions/workflows/tests.yml/badge.svg
   :target: https://github.com/nexdatas/nxsconfigserver/actions
   :alt:

.. |docs| image:: https://img.shields.io/badge/Documentation-webpages-ADD8E6.svg
   :target: https://nexdatas.github.io/nxsconfigserver/index.html
   :alt:

.. |Pypi Version| image:: https://img.shields.io/pypi/v/nxsconfigserver.svg
                  :target: https://pypi.python.org/pypi/nxsconfigserver
                  :alt:

.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/nxsconfigserver.svg
                     :target: https://pypi.python.org/pypi/nxsconfigserver/
                     :alt:



Authors: Jan Kotanski, Eugen Wintersberger, Halil Pasic

NeXuS Configuration Server is a Tango Server with its implementation based
on a MySQL database. It allows to store XML configuration datasources
and components. It also gives possibility to select mandatory components
and perform the process of component merging.

Tango Server API: https://nexdatas.github.io/nxsconfigserver/doc_html

| Source code: https://github.com/nexdatas/nxsconfigserver/
| Web page: https://nexdatas.github.io/nxsconfigserver/
| NexDaTaS Web page: https://nexdatas.github.io

------------
Installation
------------

Install the dependencies:

|    MySQLdb, PyTango, sphinx

From sources
^^^^^^^^^^^^

Download the latest version of NeXuS Configuration Server from

|    https://github.com/nexdatas/nxsconfigserver/
|    https://github.com/nexdatas/nxsconfigserver-db/

Extract the sources and run

.. code-block:: console

	  $ python setup.py install

To set database execute

.. code-block:: console

	  $ mysql < conf/mysql_create.sql

with proper privileges.

Debian packages
^^^^^^^^^^^^^^^

Debian Bookworm, Bullseye, Buster and as well as Ubuntu Lunar, Jammy  packages can be found in the HDRI repository.

To install the debian packages, add the PGP repository key

.. code-block:: console

	  $ sudo su
	  $ wget -q -O - http://repos.pni-hdri.de/debian_repo.pub.gpg | apt-key add -

and then download the corresponding source list, e.g. for bookworm

.. code-block:: console

	  $ cd /etc/apt/sources.list.d
	  $ wget http://repos.pni-hdri.de/bookworm-pni-hdri.list

Finally, for python2 packages

.. code-block:: console

	  $ apt-get update
	  $ apt-get install python-nxsconfigserver nxsconfigserver-db

and the NXSConfigServer tango server (from 2.10.0)

	  $ apt-get install nxsconfigserver

or for python3

.. code-block:: console

	  $ apt-get update
	  $ apt-get install python3-nxsconfigserver nxsconfigserver-db

and the NXSConfigServer tango server (from 2.10.0)

	  $ apt-get install nxsconfigserver3


From pip
""""""""

To install it from pip you need pymysqldb e.g.

.. code-block:: console

   $ python3 -m venv myvenv
   $ . myvenv/bin/activate

   $ pip install pymysqldb

   $ pip install nxsconfigserver

Moreover it is also good to install

.. code-block:: console

   $ pip install pytango
   $ pip install nxstools

Setting NeXus Configuration Server
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

To set up  NeXus Configuration Server with the default configuration run

.. code-block:: console

          $ nxsetup -x NXSConfigServer

The *nxsetup* command comes from the **python-nxstools** package.

===========
Description
===========

Configuration Server is dedicated to store NXDL-like configuration needed for
Tango Data Writer runs. The server uses as a storage system a MYSQL database.
To create required DB tables one can use ndts.sql script from the repository.

In Configuration Server the configuration is memorized in separate elements:
datasources or components.

**DataSources** describe access to input data, i.e to specific hardware
TANGO devices or other databases as well to client data.

**Components** specify Nexus tree with positions of datasets for particular
pieces of hardware and writing strategy for corresponding to them data.

+ They can include datasources directly as well as links to datasources
  defined in the server. To this end template syntax of
  $datasources.<ds_name> type is used.
+ Moreover, they can holds links to other components which describe their
  dependences. In this case $components.<comp_name> syntax is used.
+ Finally, the components can contains variables. The variables are defined
  in XML code by $var.<var_name> syntax and can be provided to
  the Configuration Server by passing a JSON string.
  The default value for variables is an empty string.

All elements of configuration can be created by GUI tool - ComponentDesigner.
The tool can connect to Configuration Server and fetch or store
the separate elements of the XML configuration.

During creation of the final configuration Configuration Server merges
all required and dependent components, connected to them datasources and
provided values of the variables. As a result it returns a single XML string.
This XML string can be pass directly into the dedicated Tango Data Writer
attribute.



===========
Client code
===========

.. code-block:: python

    # In this section we present an example how to communicate with
    # Configuration Server making use of PyTango.

    import tango

    cnfServer = tango.DeviceProxy("p00/xmlconfigserver/exp.01")

    cnfServer.JSONSettings = \
	'{"db":"ndts_p02","read_default_file":"/etc/my.cnf","use_unicode":true}'

    # opens DB connection
    cnfServer.Open()

    # After creating the server proxy we can set configuration for connection to
    #  the MYSQL DB.
    # The JSONSettings attribute is memorized so you have to write it only when you
    # change configuration of DB connection. Next, we open connection to
    # DB specified by our JSONSettings.



    # stores default component
    cpxml = open("default.xml", 'r').read()
    cnfServer.XMLString = cpxml
    cnfServer.StoreComponent('default')

    # stores slit1 component in DB
    cpxml = open("slit1.xml", 'r').read()
    cnfServer.XMLString = cpxml
    cnfServer.StoreComponent('slit1')

    # stores slit2 component in DB
    cpxml = open("slit2.xml", 'r').read()
    cnfServer.XMLString = cpxml
    cnfServer.StoreComponent('slit2')

    # stores slit3 component in DB
    cpxml = open("slit3.xml", 'r').read()
    cnfServer.XMLString = cpxml
    cnfServer.StoreComponent('slit3')

    # stores pilatus300k component in DB
    cpxml = open("pilatus.xml", 'r').read()
    cnfServer.XMLString = cpxml
    cnfServer.StoreComponent('pilatus300k')


    # stores motor01 datasource in DB
    dsxml = open("motor.ds.xml", 'r').read()
    cnfServer.XMLString = dsxml
    cnfServer.StoreDataSource('motor01')

    # stores motor02 datasource in DB
    dsxml = open("motor.ds.xml", 'r').read()
    cnfServer.XMLString = dsxml
    cnfServer.StoreDataSource('motor02')



    # removes slit3 component from DB
    cnfServer.DeleteComponent('slit3')

    # removes motor02 datasource from DB
    cnfServer.DeleteDataSource('motor02')

    # If someone cannot use ComponentDesigner it is also an option to store
    # or delete components and datasources using directly tango interface
    # as it is shown above.



    # provides names of available components
    cmpNameList = cnfServer.AvailableComponents()
    # provides names of available datasources
    dsNameList = cnfServer.AvailableDataSources()

    # To get information about names of available components and datasources
    # in Configuration Server we use the above commands.



    # provides a list of required components
    cmpList = cnfServer.Components(cmpNameList)
    # provides a list of required Datasources
    dsList = cnfServer.DataSources(dsNameList)

    # Having names of stored elements we can get their XML code.

    # provides a list of Datasources from a given Component
    dsList = cnf.Server.ComponentDataSources('pilatus300k')
    dsList = cnf.Server.ComponentsDataSources(['pilatus300k', 'slit1'])

    # as well as query Configuration Server which datasource
    # are related to the particular component.

    # provides a dependent components
    cpList = cnf.Server.DependentComponents(['pilatus300k', 'slit3'])


    # Moreover, one can also query Configuration Server for a list of
    # dependent components

    # provides a list of Variables from a given components
    varList = cnf.Server.ComponentVariables('pilatus300k')
    varList = cnf.Server.ComponentsVariables(['pilatus300k', 'slit3'])

    #or ask for a list of variables which are related to the particular components.

    # sets values of variables
    cnf.Server.Variables = '{"entry_id":"123","beamtime_id":"123453535453"}'

    #The variable values can be passed to the Configuration Server
    # via a JSON string.



    # sets given component as mandatory for the final configuration
    cnfServer.SetMandatoryComponents(['default','slit1'])
    # un-sets given component as mandatory for the final configuration
    cnfServer.UnsetMandatoryComponents(['slit1'])

    # provides names of mandatory components
    man =  cnfServer.MandatoryComponents()

    # Some of the component can be set as mandatory in
    # the final configuration. To define them Configuration Server provides
    # above commands.



    # provides the current configuration version
    version =  cnfServer.Version

    # Each configuration has a revision number. It can be found
    # together with Configuration Server version in Version attribute.

    # creates the final configuration from slit2 and pilatus300k
    # as well as all mandatory components
    cnfServer.CreateConfiguration('slit2', 'pilatus300k')
    # XML string ready to use by Tango Data Server
    finalXML = cnfServer.XMLString

    # In order to create our final configuration we execute CreateConfiguration
    # command with a list of names of required components. The command merges
    # these components with mandatory ones and provides the resulting NXDL-like
    # configuration in the XMLString attribute.




    # merges given components
    mergedComp = cnfServer.Merge(['slit2', 'pilatus300k'])

    # Similarly, the Merge command provides configuration by unresolved links
    # to datasoures and with non-assigned variable values.


    # closes connection to DB
    cnfServer.close()

    # Command close terminates our connection to the DB server.

=======================
Configuration Variables
=======================

Values of configuration variables can be also define inside the component xmls.
Let's consider two following components:

*mydetector* with a general detector transformation group

.. code-block:: xml

   <definition>
     <group type='NXentry' name='entry'>
       <group type='NXinstrument' name='instrument'>
          <group type='NXdetector' name='$var.detector#\"mydetector\"'>
             <group type='NXtransformations' name='transformations'/>
	  </group>
       </group>
     </group>
   </definition>

and *pilatus* created for the particular detector

.. code-block:: xml

   <definition>
     <group type='NXentry' name='entry'>
       <group type='NXinstrument' name='instrument'>
          <group type='NXdetector' name='pilatus'>
             <field type='NX_FLOAT64' name='data'/>
	  </group>
       </group>
     </group>
     <doc>$var(detector=pilatus)</doc>
   </definition>


Creating configuration without variables

.. code-block:: python

   cnfServer.Variables = '{}'
   cnfServer.CreateConfiguration(["mydetector"])

results in

.. code-block:: xml

   <definition>
     <group type='NXentry' name='entry'>
       <group type='NXinstrument' name='instrument'>
          <group type='NXdetector' name='mydetector'>
             <group type='NXtransformations' name='transformations'/>
	  </group>
       </group>
     </group>
   </definition>

When configuration variables are defined

.. code-block:: python

   cnfServer.Variables = '{"detector": "det1"}'
   cnfServer.CreateConfiguration(["mydetector"])

one can get

.. code-block:: xml

   <definition>
     <group type='NXentry' name='entry'>
       <group type='NXinstrument' name='instrument'>
          <group type='NXdetector' name='det1'>
             <group type='NXtransformations' name='transformations'/>
	  </group>
       </group>
     </group>
   </definition>

Finally, creating configuration xml from our two components without variables

.. code-block:: python

   cnfServer.Variables = '{}'
   cnfServer.CreateConfiguration(["mydetector", "pilatus"])

results in

.. code-block:: xml

   <definition>
   <group name="entry" type="NXentry">
     <group name="instrument" type="NXinstrument">
       <group name="pilatus" type="NXdetector">
         <group name="transformations" type="NXtransformations"/>
         <field name="data" type="NX_FLOAT64"/>
	 </group>
       </group>
     </group>
     <doc>$var(detector=pilatus)</doc>
   </definition>



            

Raw data

            {
    "_id": null,
    "home_page": "http://github.com/jkotan/nexdatas/nxsconfigserver",
    "name": "nxsconfigserver",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "configuration MySQL writer Tango server nexus data",
    "author": "Jan Kotanski, Eugen Wintersberger , Halil Pasic",
    "author_email": "jankotan@gmail.com, eugen.wintersberger@gmail.com, halil.pasic@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/69/0e/db9e1fc66945f198d1b36459316e44e40a4f787b54a4da1a964fb2eb5edc/nxsconfigserver-2.15.0.tar.gz",
    "platform": null,
    "description": "======================================================\nWelcome to NeXuS Configuration Server's documentation!\n======================================================\n\n|github workflow|\n|docs|\n|Pypi Version|\n|Python Versions|\n\n.. |github workflow| image:: https://github.com/nexdatas/nxsconfigserver/actions/workflows/tests.yml/badge.svg\n   :target: https://github.com/nexdatas/nxsconfigserver/actions\n   :alt:\n\n.. |docs| image:: https://img.shields.io/badge/Documentation-webpages-ADD8E6.svg\n   :target: https://nexdatas.github.io/nxsconfigserver/index.html\n   :alt:\n\n.. |Pypi Version| image:: https://img.shields.io/pypi/v/nxsconfigserver.svg\n                  :target: https://pypi.python.org/pypi/nxsconfigserver\n                  :alt:\n\n.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/nxsconfigserver.svg\n                     :target: https://pypi.python.org/pypi/nxsconfigserver/\n                     :alt:\n\n\n\nAuthors: Jan Kotanski, Eugen Wintersberger, Halil Pasic\n\nNeXuS Configuration Server is a Tango Server with its implementation based\non a MySQL database. It allows to store XML configuration datasources\nand components. It also gives possibility to select mandatory components\nand perform the process of component merging.\n\nTango Server API: https://nexdatas.github.io/nxsconfigserver/doc_html\n\n| Source code: https://github.com/nexdatas/nxsconfigserver/\n| Web page: https://nexdatas.github.io/nxsconfigserver/\n| NexDaTaS Web page: https://nexdatas.github.io\n\n------------\nInstallation\n------------\n\nInstall the dependencies:\n\n|    MySQLdb, PyTango, sphinx\n\nFrom sources\n^^^^^^^^^^^^\n\nDownload the latest version of NeXuS Configuration Server from\n\n|    https://github.com/nexdatas/nxsconfigserver/\n|    https://github.com/nexdatas/nxsconfigserver-db/\n\nExtract the sources and run\n\n.. code-block:: console\n\n\t  $ python setup.py install\n\nTo set database execute\n\n.. code-block:: console\n\n\t  $ mysql < conf/mysql_create.sql\n\nwith proper privileges.\n\nDebian packages\n^^^^^^^^^^^^^^^\n\nDebian Bookworm, Bullseye, Buster and as well as Ubuntu Lunar, Jammy  packages can be found in the HDRI repository.\n\nTo install the debian packages, add the PGP repository key\n\n.. code-block:: console\n\n\t  $ sudo su\n\t  $ wget -q -O - http://repos.pni-hdri.de/debian_repo.pub.gpg | apt-key add -\n\nand then download the corresponding source list, e.g. for bookworm\n\n.. code-block:: console\n\n\t  $ cd /etc/apt/sources.list.d\n\t  $ wget http://repos.pni-hdri.de/bookworm-pni-hdri.list\n\nFinally, for python2 packages\n\n.. code-block:: console\n\n\t  $ apt-get update\n\t  $ apt-get install python-nxsconfigserver nxsconfigserver-db\n\nand the NXSConfigServer tango server (from 2.10.0)\n\n\t  $ apt-get install nxsconfigserver\n\nor for python3\n\n.. code-block:: console\n\n\t  $ apt-get update\n\t  $ apt-get install python3-nxsconfigserver nxsconfigserver-db\n\nand the NXSConfigServer tango server (from 2.10.0)\n\n\t  $ apt-get install nxsconfigserver3\n\n\nFrom pip\n\"\"\"\"\"\"\"\"\n\nTo install it from pip you need pymysqldb e.g.\n\n.. code-block:: console\n\n   $ python3 -m venv myvenv\n   $ . myvenv/bin/activate\n\n   $ pip install pymysqldb\n\n   $ pip install nxsconfigserver\n\nMoreover it is also good to install\n\n.. code-block:: console\n\n   $ pip install pytango\n   $ pip install nxstools\n\nSetting NeXus Configuration Server\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nTo set up  NeXus Configuration Server with the default configuration run\n\n.. code-block:: console\n\n          $ nxsetup -x NXSConfigServer\n\nThe *nxsetup* command comes from the **python-nxstools** package.\n\n===========\nDescription\n===========\n\nConfiguration Server is dedicated to store NXDL-like configuration needed for\nTango Data Writer runs. The server uses as a storage system a MYSQL database.\nTo create required DB tables one can use ndts.sql script from the repository.\n\nIn Configuration Server the configuration is memorized in separate elements:\ndatasources or components.\n\n**DataSources** describe access to input data, i.e to specific hardware\nTANGO devices or other databases as well to client data.\n\n**Components** specify Nexus tree with positions of datasets for particular\npieces of hardware and writing strategy for corresponding to them data.\n\n+ They can include datasources directly as well as links to datasources\n  defined in the server. To this end template syntax of\n  $datasources.<ds_name> type is used.\n+ Moreover, they can holds links to other components which describe their\n  dependences. In this case $components.<comp_name> syntax is used.\n+ Finally, the components can contains variables. The variables are defined\n  in XML code by $var.<var_name> syntax and can be provided to\n  the Configuration Server by passing a JSON string.\n  The default value for variables is an empty string.\n\nAll elements of configuration can be created by GUI tool - ComponentDesigner.\nThe tool can connect to Configuration Server and fetch or store\nthe separate elements of the XML configuration.\n\nDuring creation of the final configuration Configuration Server merges\nall required and dependent components, connected to them datasources and\nprovided values of the variables. As a result it returns a single XML string.\nThis XML string can be pass directly into the dedicated Tango Data Writer\nattribute.\n\n\n\n===========\nClient code\n===========\n\n.. code-block:: python\n\n    # In this section we present an example how to communicate with\n    # Configuration Server making use of PyTango.\n\n    import tango\n\n    cnfServer = tango.DeviceProxy(\"p00/xmlconfigserver/exp.01\")\n\n    cnfServer.JSONSettings = \\\n\t'{\"db\":\"ndts_p02\",\"read_default_file\":\"/etc/my.cnf\",\"use_unicode\":true}'\n\n    # opens DB connection\n    cnfServer.Open()\n\n    # After creating the server proxy we can set configuration for connection to\n    #  the MYSQL DB.\n    # The JSONSettings attribute is memorized so you have to write it only when you\n    # change configuration of DB connection. Next, we open connection to\n    # DB specified by our JSONSettings.\n\n\n\n    # stores default component\n    cpxml = open(\"default.xml\", 'r').read()\n    cnfServer.XMLString = cpxml\n    cnfServer.StoreComponent('default')\n\n    # stores slit1 component in DB\n    cpxml = open(\"slit1.xml\", 'r').read()\n    cnfServer.XMLString = cpxml\n    cnfServer.StoreComponent('slit1')\n\n    # stores slit2 component in DB\n    cpxml = open(\"slit2.xml\", 'r').read()\n    cnfServer.XMLString = cpxml\n    cnfServer.StoreComponent('slit2')\n\n    # stores slit3 component in DB\n    cpxml = open(\"slit3.xml\", 'r').read()\n    cnfServer.XMLString = cpxml\n    cnfServer.StoreComponent('slit3')\n\n    # stores pilatus300k component in DB\n    cpxml = open(\"pilatus.xml\", 'r').read()\n    cnfServer.XMLString = cpxml\n    cnfServer.StoreComponent('pilatus300k')\n\n\n    # stores motor01 datasource in DB\n    dsxml = open(\"motor.ds.xml\", 'r').read()\n    cnfServer.XMLString = dsxml\n    cnfServer.StoreDataSource('motor01')\n\n    # stores motor02 datasource in DB\n    dsxml = open(\"motor.ds.xml\", 'r').read()\n    cnfServer.XMLString = dsxml\n    cnfServer.StoreDataSource('motor02')\n\n\n\n    # removes slit3 component from DB\n    cnfServer.DeleteComponent('slit3')\n\n    # removes motor02 datasource from DB\n    cnfServer.DeleteDataSource('motor02')\n\n    # If someone cannot use ComponentDesigner it is also an option to store\n    # or delete components and datasources using directly tango interface\n    # as it is shown above.\n\n\n\n    # provides names of available components\n    cmpNameList = cnfServer.AvailableComponents()\n    # provides names of available datasources\n    dsNameList = cnfServer.AvailableDataSources()\n\n    # To get information about names of available components and datasources\n    # in Configuration Server we use the above commands.\n\n\n\n    # provides a list of required components\n    cmpList = cnfServer.Components(cmpNameList)\n    # provides a list of required Datasources\n    dsList = cnfServer.DataSources(dsNameList)\n\n    # Having names of stored elements we can get their XML code.\n\n    # provides a list of Datasources from a given Component\n    dsList = cnf.Server.ComponentDataSources('pilatus300k')\n    dsList = cnf.Server.ComponentsDataSources(['pilatus300k', 'slit1'])\n\n    # as well as query Configuration Server which datasource\n    # are related to the particular component.\n\n    # provides a dependent components\n    cpList = cnf.Server.DependentComponents(['pilatus300k', 'slit3'])\n\n\n    # Moreover, one can also query Configuration Server for a list of\n    # dependent components\n\n    # provides a list of Variables from a given components\n    varList = cnf.Server.ComponentVariables('pilatus300k')\n    varList = cnf.Server.ComponentsVariables(['pilatus300k', 'slit3'])\n\n    #or ask for a list of variables which are related to the particular components.\n\n    # sets values of variables\n    cnf.Server.Variables = '{\"entry_id\":\"123\",\"beamtime_id\":\"123453535453\"}'\n\n    #The variable values can be passed to the Configuration Server\n    # via a JSON string.\n\n\n\n    # sets given component as mandatory for the final configuration\n    cnfServer.SetMandatoryComponents(['default','slit1'])\n    # un-sets given component as mandatory for the final configuration\n    cnfServer.UnsetMandatoryComponents(['slit1'])\n\n    # provides names of mandatory components\n    man =  cnfServer.MandatoryComponents()\n\n    # Some of the component can be set as mandatory in\n    # the final configuration. To define them Configuration Server provides\n    # above commands.\n\n\n\n    # provides the current configuration version\n    version =  cnfServer.Version\n\n    # Each configuration has a revision number. It can be found\n    # together with Configuration Server version in Version attribute.\n\n    # creates the final configuration from slit2 and pilatus300k\n    # as well as all mandatory components\n    cnfServer.CreateConfiguration('slit2', 'pilatus300k')\n    # XML string ready to use by Tango Data Server\n    finalXML = cnfServer.XMLString\n\n    # In order to create our final configuration we execute CreateConfiguration\n    # command with a list of names of required components. The command merges\n    # these components with mandatory ones and provides the resulting NXDL-like\n    # configuration in the XMLString attribute.\n\n\n\n\n    # merges given components\n    mergedComp = cnfServer.Merge(['slit2', 'pilatus300k'])\n\n    # Similarly, the Merge command provides configuration by unresolved links\n    # to datasoures and with non-assigned variable values.\n\n\n    # closes connection to DB\n    cnfServer.close()\n\n    # Command close terminates our connection to the DB server.\n\n=======================\nConfiguration Variables\n=======================\n\nValues of configuration variables can be also define inside the component xmls.\nLet's consider two following components:\n\n*mydetector* with a general detector transformation group\n\n.. code-block:: xml\n\n   <definition>\n     <group type='NXentry' name='entry'>\n       <group type='NXinstrument' name='instrument'>\n          <group type='NXdetector' name='$var.detector#\\\"mydetector\\\"'>\n             <group type='NXtransformations' name='transformations'/>\n\t  </group>\n       </group>\n     </group>\n   </definition>\n\nand *pilatus* created for the particular detector\n\n.. code-block:: xml\n\n   <definition>\n     <group type='NXentry' name='entry'>\n       <group type='NXinstrument' name='instrument'>\n          <group type='NXdetector' name='pilatus'>\n             <field type='NX_FLOAT64' name='data'/>\n\t  </group>\n       </group>\n     </group>\n     <doc>$var(detector=pilatus)</doc>\n   </definition>\n\n\nCreating configuration without variables\n\n.. code-block:: python\n\n   cnfServer.Variables = '{}'\n   cnfServer.CreateConfiguration([\"mydetector\"])\n\nresults in\n\n.. code-block:: xml\n\n   <definition>\n     <group type='NXentry' name='entry'>\n       <group type='NXinstrument' name='instrument'>\n          <group type='NXdetector' name='mydetector'>\n             <group type='NXtransformations' name='transformations'/>\n\t  </group>\n       </group>\n     </group>\n   </definition>\n\nWhen configuration variables are defined\n\n.. code-block:: python\n\n   cnfServer.Variables = '{\"detector\": \"det1\"}'\n   cnfServer.CreateConfiguration([\"mydetector\"])\n\none can get\n\n.. code-block:: xml\n\n   <definition>\n     <group type='NXentry' name='entry'>\n       <group type='NXinstrument' name='instrument'>\n          <group type='NXdetector' name='det1'>\n             <group type='NXtransformations' name='transformations'/>\n\t  </group>\n       </group>\n     </group>\n   </definition>\n\nFinally, creating configuration xml from our two components without variables\n\n.. code-block:: python\n\n   cnfServer.Variables = '{}'\n   cnfServer.CreateConfiguration([\"mydetector\", \"pilatus\"])\n\nresults in\n\n.. code-block:: xml\n\n   <definition>\n   <group name=\"entry\" type=\"NXentry\">\n     <group name=\"instrument\" type=\"NXinstrument\">\n       <group name=\"pilatus\" type=\"NXdetector\">\n         <group name=\"transformations\" type=\"NXtransformations\"/>\n         <field name=\"data\" type=\"NX_FLOAT64\"/>\n\t </group>\n       </group>\n     </group>\n     <doc>$var(detector=pilatus)</doc>\n   </definition>\n\n\n",
    "bugtrack_url": null,
    "license": "GNU GENERAL PUBLIC LICENSE v3",
    "summary": "Configuration Server for Nexus Data Writer",
    "version": "2.15.0",
    "project_urls": {
        "Homepage": "http://github.com/jkotan/nexdatas/nxsconfigserver"
    },
    "split_keywords": [
        "configuration",
        "mysql",
        "writer",
        "tango",
        "server",
        "nexus",
        "data"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "34d289e0ff1217b7e807c9038501063b609135dae6619dfc21bdedabfbd1d870",
                "md5": "71013b7da6f02ae45344c84c993e18fd",
                "sha256": "163bbc1b1b1f3627836fdea6089e334a2a0d28e57cf995b8b4c8205a44682600"
            },
            "downloads": -1,
            "filename": "nxsconfigserver-2.15.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "71013b7da6f02ae45344c84c993e18fd",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 31326,
            "upload_time": "2023-11-10T13:15:00",
            "upload_time_iso_8601": "2023-11-10T13:15:00.753714Z",
            "url": "https://files.pythonhosted.org/packages/34/d2/89e0ff1217b7e807c9038501063b609135dae6619dfc21bdedabfbd1d870/nxsconfigserver-2.15.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "690edb9e1fc66945f198d1b36459316e44e40a4f787b54a4da1a964fb2eb5edc",
                "md5": "fc7d88531bb5a1b3b82d8bbb3b3a9ee8",
                "sha256": "60f31fd09f6eb25a3a3a4b0b3b7e76e5f6add5f10eb514e896753fa8405fe3d6"
            },
            "downloads": -1,
            "filename": "nxsconfigserver-2.15.0.tar.gz",
            "has_sig": false,
            "md5_digest": "fc7d88531bb5a1b3b82d8bbb3b3a9ee8",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 110996,
            "upload_time": "2023-11-10T13:15:10",
            "upload_time_iso_8601": "2023-11-10T13:15:10.477398Z",
            "url": "https://files.pythonhosted.org/packages/69/0e/db9e1fc66945f198d1b36459316e44e40a4f787b54a4da1a964fb2eb5edc/nxsconfigserver-2.15.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-11-10 13:15:10",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "jkotan",
    "github_project": "nexdatas",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "nxsconfigserver"
}
        
Elapsed time: 0.13644s