fesa-dev-dump, fesa-dev-load

Both tools are using Python cmwrda, so don't forget to specify production environment by option --pro --dev --int or by setting environment variable RDAPY_SYSTEM_ENVIRONMENT=pro (respectivly to dev or int).

fesa-dev-dump

Reads data from a given property (default is Setting), displays the data and save them in a file.

Data are dumped for a range of selector indices. Selector indices are specified as combination of comma separated single values and ranges (7,9,15,16,17,18 is equivalent to 7,9,15-18). Selector indices can be given by option -p (beam process only) or option -s (all types of selectors, specified as -s <type>=<indices>)

A front-end server can be specified explicitly, e.g. -S PowerSupplyDev_DU.kp2cu01. When specified explicitly, the device has not to be exported to the FESA database.

A reworked version 3.1 was installed May 26 2020:

• reworked format of generated data file, requires version 3.1 of fesa-dev-load
• previous version 3.0 can be called by option --prior
• all selector types are supported now (process, sequence, chain, and timing)
  
  • option -s <type>=<list of indexes>, e.g.
    • -s P=1,3-5,7 process indexes 1,3,4,5,7
    • -s S=4-6 sequence indexes 4,5,6
    • -s C=17,4 chain index 4,17
  • former option -s <server> is renamed to -S <server>
  • former option -p is still available, for convinience
  • neither option -s nor -p: no selector
• new option -c (computer):
  nomenclature is taken as a front-end computer, fesa-dev-dump works on all devices on this front-end computer
• previous version 3.0 can be called with option --prior

usage: fesa-dev-dump [-h] [--pro|--dev|--int] [--prior]
                     [-c] [-d] [-f] [-o FILE] [-p PROCESS] [-q] [-s SELECTOR] [-S SERVER]
                     NOMEN [PROPERTY]

dump data from FESA devices to file

positional arguments:
  NOMEN                 device nomenclature
  PROPERTY              device property (optional, default: Setting)

optional arguments:
  -h, --help            show this help message and exit
  --dev                 select development environment
  --int                 select integration environment
  --pro                 select production environment
  --prior               use previous version of program
  -c, --computer        NOMEN is a front-end computer
  -d, --display_only    read data and display only, no writing to file
  -f, --force           do not prompt for dump action
  -o OUTPUT, --output OUTPUT
                        name of output-file (default: <nomen>.dmp)
  -p PROCESS, --process PROCESS
                        list of beam process numbers and ranges,
                          shortcut for -s P=<beam process numbers>
                          specify ranges with hyphen, like 4-17
                          e.g. -p 4,5,10-15,19,30-36
                          no spaces allowed in list
  -q, --quiet           do not display read data
  -s [SELECTOR], --selector [SELECTOR]
                        selector for data-indexing
                          C|T|S|P=<list of indexes and ranges>  no space between list elements
                          e.g. C=1,3,5-8   chain indexes 1,3,5,6,7,8
                          P=3,5-9 is equivalent to -p 3,5-9
  -S SERVER, --server SERVER
                        name of front-end server

fesa-dev-load

Re-loads data which have been dumped by fesa-dev-dump to device: reads saved data from file and loads back to device.

A front-end server can be specified explicitly, e.g. -S PowerSupplyDev_DU.kp2cu01. When specified explicitly, the device has not to be exported to the FESA database.

A reworked version 3.1 was installed May 26 2020. The former version 3.0 can be called by option --prior.

Nomenclature and the selector (type and indices) are taken as stored in the data file. Both can be overwritten by command line options:

• Option -n <list of nomenclatures>: Requires comma separated list of nomenclatures, without spaces
  first nomenclature in list replaces first nomenclature in file, second in list replaces second in file, etc.
  if file contains more nomenclatures than the option's list, surplus data in file will be skipped
• Option -s <list of selector indices/ranges>: Requires comma separated list of selector indices and ranges, with preceeding type indicator, without spaces
  e.g. -s P=8,12-14,17 : beam process indices 8, 12, 13, 14, 17, -s C=1-3,5,7-9 : chain indices 1, 2, 3, 5, 7, 8, 9
  option -p is still provided for convinience, -s P=1,2-4 and -p 1,2-4 are identical
  first selector index in list replaces first selector index in file, second index in list replaces second in file, etc
  if file contains more data than option's list, surplus file data will be skipped

Version 3.1 should be able to load data which were dumped by fesa-dev-dump version 3.0

Files are pure text files, contents is structured as JSON data. As long as file structure is preserved, contents can be modified in an text editor, eg. nomenclatures, beam process number or data values, and other data, can be modified.

usage: fesa-dev-load [-h] [--pro|--dev|--int] [--prior]
                     [-f] [-p PROCESS-list] [-q] [-s SELECTOR-list] [-S SERVER] [-v] [-n NOMEN]
                     FILE

load data which are dumped by fesa-dump

positional arguments:
  FILE                  dumped data file

optional arguments:
  -h, --help            show this help message and exit
  --dev                 select development environment
  --int                 select integration environment
  --pro                 select production environment
  --prior               use previous version of program
  -f, --force           do not prompt for load action (take care!)
  -n NOMEN, --nomen NOMEN
                        list of nomenclatures, override nomen-entries from file
  -p PROCESS, --process PROCESS
                        list of beam process numbers and ranges,
                          shortcut for -s P=<beam process numbers>
                          ** override selectors from file **
                          specify ranges with hyphen, like 4-17
                          e.g. -p 4,5,10-15,19,30-36
                          no spaces allowed in list
  -q, --quiet           do not display written data
  -s [SELECTOR], --selector [SELECTOR]
                        selector for data-indexing
                          ** override selectors from file **
                          C|T|S|P=<list of indexes and ranges>  no space between list elements
                          e.g. C=1,3,5-8   chain indexes 1,3,5,6,7,8
                          -P=3,5-9 is equivalent to -p 3,5-9
  -S SERVER, --server SERVER
                        name of front-end server
  -v, --verbose         verbose, display data values