Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel

Anchor
pyana.event.Event
pyana.event.Event

Class pyana.event.Event

Instance of this class contains all event data.


Construction

Usage: evt = pyana.event.Event(dg)

Creates event object from the corresponding XTC datagram object.

Parameters:


Method damage()

Usage: val = evt.damage()

Returns object of type PSDM:_pdsdata.xtc.Damage representing damage mask. The damage mask is returned for the top-level XTC, individual sub-objects may contain different damage masks.


Method find()

Usage: objects = evt.find(...)

Returns possibly empty list of data objects contained in the event. This method accepts a number of arguments, but all arguments are optional. If no arguments are given then a list of all data objects is returned. If some arguments are given then only those objects that satisfy a particular criteria are returned. The list of possible keyword arguments:

  • typeId – accepts enum PSDM:xtc.TypeId.Type, only return objects which have that TypeId
  • version – accepts number, only return objects whose type version number is equal to number
  • level – accepts one of PSDM:xtc.Level values, only returns objects originated at that level
  • detector – accepts enum PSDM:xtc.DetInfo.Detector values, only returns objects produced by this detector
  • detId – accepts number, only returns objects produced by this detector ID
  • device – accepts enum PSDM:xtc.DetInfo.Device values, only returns objects produced by this device
  • devId – accepts number, only returns objects produced by this device ID
  • addressPSDM:xtc.DetInfo object or an address string (see User Manual)

The parameters address and any of the detector, detId, device, devId are incompatible, specify only one or another.


Method findFirst()

Usage: object = evt.findFirst(...)

Accepts the same set of arguments as find() methods but instead of list of objects returns fist object found. If no object is satisfying all selection criteria then None is returned.


Method get()

Wiki Markup
Usage: {{data = evt.get(_typeId_, \[PSDM:_address_\])}}

This is a generic method for finding an object of given type. If address is not given or is not very specific then the first matching object is returned. Note that this method returns original data types defined in _pdsdata package, not those enhanced types from pypdsdata package.

Parameters:


Method getAcqValue()

Usage: acqData = evt.getAcqValue(address, channel, env)

Returns Acqiris data object of type PSDM:pypdsdata.acqiris.DataDescV* for specific device and channel. If address given is not very specific then the first matching object is returned.

Parameters:

  • addressPSDM:xtc.DetInfo object or an address string (see User Manual)
  • channel – channel number from 0 to max number of channels
  • env – environment object containing Acqiris configuration object

Channel number is an integer number, total number of channels can be extracted from the Acqiris configuration object.


Method getCsPadQuads()

Usage: acqData = evt.getCsPadQuads(address, env)

Returns list of objects of type PSDM:pypdsdata.cspad.ElementV1 for specific device address. If address given is not very specific then the first matching object is returned.

Parameters:

The size of the list is determined by the CsPad configuration (numQuads() method of the configuration object).


Method getEBeam()

Usage: obj = evt.getEBeam()

Returns data object of type PSDM:bld.BldDataEBeam or PSDM:bld.BldDataEBeamV0 whichever is present in the event.


Method getEvrData()

Usage: obj = evt.getEvrData(address)

Returns data object of type PSDM:evr.EvrDataV* for given address.

Parameters:

This method is equivalent to evt.get(xtc.TypeId.Type.Id_EvrData, address).


Method getFeeGasDet()

Usage: array = evt.getFeeGasDet()

Wiki Markup
Returns the list of 4 numbers {{\[PSDM:f_11_ENRC, f_12_ENRC, f_21_ENRC, f_22_ENRC\]}} obtained from [PSDM:{{bld.BldDataFEEGasDetEnergy}}|#_pdsdata.bld.BldDataFEEGasDetEnergy] object.


Method getFrameValue()

Usage: frame = evt.getFrameValue(address)

Returns frame data object of type PSDM:camera.FrameV* for specific device. If address given is not very specific then the first matching object is returned.

Parameters:

This method is equivalent to evt.get(xtc.TypeId.Type.Id_Frame, address).


Method getIpimbValue()

Usage: frame = evt.getIpimbValue(address)

Returns frame data object of type PSDM:ipimb.DataV* for specific device. If address given is not very specific then the first matching object is returned.

Parameters:

This method is equivalent to evt.get(xtc.TypeId.Type.Id_IpimbData, address).


Method getOpal1kValue()

Usage: frame = evt.getOpal1kValue(address)

This methods is an alias for getFrameValue().


Method getPhaseCavity()

Usage: obj = evt.getPhaseCavity()

Returns data object of type PSDM:bld.BldDataPhaseCavity.


Method getPnCcdValue()

Usage: frame = evt.getPnCcdValue(address, env)

returns pnCCD data object of type PSDM:pypdsdata.pnccd.FrameV* for specific device. If address given is not very specific then the first matching object is returned.

Parameters:

  • addressPSDM:xtc.DetInfo object or an address string (see User Manual)
  • env – environment object containing pnCCD configuration object

Method getPrincetonValue()

Usage: frame = evt.getPrincetonValue(address, env)

Returns Princeton frame object of type PSDM:pypdsdata.princeton.Frame* for specific device. If address given is not very specific then the first matching object is returned.

Parameters:

  • addressPSDM:xtc.DetInfo object or an address string (see User Manual)
  • env – environment object containing Acqiris configuration object

Method getTime()

Usage: t = evt.getTime()

Returns PSDM:_pdsdata.xtc.ClockTime object, equivalent to dg.seq.clock()


Method run()

Usage: run = evt.run()

Returns run number as integer value. Run number is extracted from the file names being processed. When the file name cannot be determined or has unknown format the above method will return negative number.


Method seq()

Usage: s = evt.seq()

Returns PSDM:_pdsdata.xtc.Sequence object, equivalent to dg.seq

...

Panel

Anchor
pyana.event.Env
pyana.event.Env

Class pyana.event.Env

Instance of this class is a container for all sorts of environment data.


Construction

Usage: env = pyana.event.Env(jobName="pyana", hmgr=None, subproc=-1)

Creates environment object.

Parameters:

  • jobName – analysis job name, arbitrary string
  • hmgr – histogram manager object
  • subproc – the sub-process number starting with 0, should be set to negative number for parent process

Objects of this type are created by pyana itself and end users do not need to create new instances.


Method epicsStore()

Usage: store = env.epicsStore()

This is the primary method for user code to access EPICS data. It returns PSDM:event.EpicsStore object which can be used to retrieve the state of the individual EPICS channels.


Method getConfig()

Wiki Markup
Usage: {{onfig = env.getConfig(_typeId_, \[PSDM:_address_\])}}

This is a generic method for finding a configuration object of given type. If address is not given or is not very specific then the first matching object is returned.

Parameters:


Method getAcqConfig()

Usage: acqConfig = env.getAcqConfig(address)

Returns PSDM:Acqiris configuration object for a given device address. If more than one object is matched by the parameters then first arbitrary object is returned. None is returned if no object is found.

Parameters:

This method is equivalent to env.getConfig(xtc.TypeId.Type.Id_AcqConfig, address).


Method getOpal1kConfig()

Usage: opalConfig = env.getOpal1kConfig(address)

Returns PSDM:Opal1k configuration object for a given device address. If more than one object is matched by the parameters then first arbitrary object is returned. None is returned if no object is found.

Parameters:

This method is equivalent to env.getConfig(xtc.TypeId.Type.Id_Opal1kConfig, address).


Method getPnCCDConfig()

Usage: pnccdConfig = env.getPnCCDConfig(address)

Returns PSDM:pnCCD configuration object for a given device address. If more than one object is matched by the parameters then first arbitrary object is returned. None is returned if no object is found.

Parameters:

This method is equivalent to env.getConfig(xtc.TypeId.Type.Id_pnCCDconfig, address).


Method getPrincetonConfig()

Usage: onfig = env.getPrincetonConfig(address)

Returns PSDM:Princeton configuration object for a given device address. If more than one object is matched by the parameters then first arbitrary object is returned. None is returned if no object is found.

Parameters:

This method is equivalent to env.getConfig(xtc.TypeId.Type.Id_PrincetonConfig, address).


Method hmgr()

Usage: hmgr = env.hmgr()

Returns histogram manager object of type pyana.histo.HistoManager*.


Method jobName()

Usage: jobName = env.jobName()

Returns analysis job name string.


Method jobNameSub()

Usage: jobName = env.jobNameSub()

Returns process-specific analysis job name string. In case of multi-processing job it will a string in format "jobName-procNum" where procNum is a number returned by subprocess(). In case of single-process job it will return the same string as jobName().


Method mkfile()

Usage: file = env.mkfile(filename, mode='w', bufsize=-1)

Opens file for writing output data. This is pyana's alternative for Python open() function which supports multi-processing. If user needs the data in this file to be merged with the files produced by other processes then mkfile() has to be used in place of open().

Parameters:

  • filename – output file name
  • mode – open mode, currently any "w*" modes are supported
  • bufsize – output buffer size, default is to use Python's default

In case of single-process job this method is equivalent to a regular Python open() method. In case of multi-processing when this method is called from a sub-process then the file is created somewhere in a temporary location (with unique name). At the end of the job files from all sub-processes are merged into one file with name filename and the temporary files are deleted.


Method subprocess()

Usage: num = env.subprocess()

Returns sub-process number. In case of multi-processing job it will be a non-negative number ranging from 0 to a total number of sub-processes. In case of single-process job it will return -1.


Method result()

Usage: data = env.result()

Method used by pyana to extract the data produced by a single sub-process in multi-processing setup. Not to be used by end users.


Method update()

Usage: env.update(evt)

This method updates environment contents with selected data from event object. This is equivalent to calling env.updateEpics() and env.updateConfig().

Parameters:

  • evt – event object of type event.Event

This method is not supposed to be called from user code, pyana takes care of all updates itself.


Method updateConfig()

Usage: env.updateConfig(evt)

This method copies configuration objects from event object into environment.

Parameters:

  • evt – event object of type event.Event

This method is not supposed to be called from user code, pyana takes care of all updates itself.


Method updateEpics()

Usage: env.updateEpics(evt)

This method updates environment EPICS data from event object.

Parameters:

This method is not supposed to be called from user code, pyana takes care of all updates itself.

...

Panel

Anchor
pyana.event.EpicsStore
pyana.event.EpicsStore

Class pyana.event.EpicsStore

Instance of this class contains current status of all EPICS channels. It is updated from event data on every new event.


Construction

Usage: store = pyana.event.EpicsStore()

Creates EPICS store object.

Objects of this type are created by pyana itself and end users do not need to create new instances.


Method update()

Usage: store.update(evt)

This method updates environment EPICS data from event object.

Parameters:

This method is not supposed to be called from user code, pyana takes care of all updates itself.


Method value()

Usage epics = store.value(name)

Returns current value of the EPICS channel with the given name. The type of returned data is either PSDM:epics.EpicsPvCtrl or PSDM:epics.EpicsPvTime.

Parameters:

  • name – name of the EPICS channel

This is the primary method to access EPICS information in pyana jobs.

...

Panel

Anchor
_pdsdata.xtc.BldInfo
_pdsdata.xtc.BldInfo

Class _pdsdata.xtc.BldInfo

Python wrapper for pdsdata/xtc/BldInfo class. Unlike C++ this class does not inherit from Src class (Src class does not exist in this module) but uses dynamic Python features to implement the same interface as in Src class. In addition to methods described here the class also defines __hash__ and __cmp__ methods based on the content of the object and can be used as a key in the dictionaries.


Anchor
_pdsdata.xtc.BldInfo.Type
_pdsdata.xtc.BldInfo.Type

Enum Type

This enum is an embedded type of BldInfo class. Following enum members are defined currently:

  • BldInfo.Type.EBeam
  • BldInfo.Type.PhaseCavity
  • BldInfo.Type.FEEGasDetEnergy
  • BldInfo.Type.NumberOf

Construction

Usage: bld = xtc.BldInfo(processId, type)

Arguments:


Method level()

Usage: lvl = bld.level()

Returns enum value of type PSDM:xtc.Level which defines source level.


Method log()

Usage: log = bld.log()

Returns logical address of data source as integer number.


Method phy()

Usage: phy = bld.phy()

Returns physical address of data source as integer number.


Method processId()

Usage: processId = bld.processId()

Returns process ID as integer number.


Method type()

Usage: type = bld.type()

Returns BldInfo type which is a value of PSDM:BldInfo.Type.

...

Panel

Anchor
_pdsdata.xtc.ClockTime
_pdsdata.xtc.ClockTime

Class _pdsdata.xtc.ClockTime

Python wrapper for pdsdata/xtc/ClockTime class. In addition to methods described here the class also defines __hash__ and __cmp__ methods based on the content of the object and can be used as a key in the dictionaries.


Construction

Wiki Markup
Usage: {{clock = xtc.ClockTime(\[_seconds_, \[PSDM:_nanoseconds_\]\])}}

Creates new instance of type.

Arguments:

  • seconds – seconds since UNIX epoch
  • nanosecods – nanoseconds within second

If any argument is missing it is assumed to be 0.


Method seconds()

Usage: sec = clock.seconds()

Returns the number of seconds as integer number.


Method nanoseconds()

Usage: nsec = clock.nanoseconds()

Returns the number of nanoseconds as integer number.

...

Panel

Anchor
_pdsdata.xtc.Damage
_pdsdata.xtc.Damage

Class _pdsdata.xtc.Damage

Python wrapper for pdsdata/xtc/Damage class.


Anchor
_pdsdata.xtc.Damage.Value
_pdsdata.xtc.Damage.Value

Enum Value

This enum is an internal type of Damage class. Following enum members are defined currently:

  • Damage.Value.DroppedContribution
  • Damage.Value.OutOfOrder
  • Damage.Value.OutOfSynch
  • Damage.Value.UserDefined
  • Damage.Value.IncompleteContribution
  • Damage.Value.ContainsIncomplete

The values of enum constants define the bit number in the damage mask.


Anchor
_pdsdata.xtc.Damage.Mask
_pdsdata.xtc.Damage.Mask

Enum Mask

Note
titlePython Only

This enum does not exist in C++ class, has been added to Python for convenience

This enum is an internal type of Damage class. Following enum members are defined currently:

  • Damage.Mask.DroppedContribution
  • Damage.Mask.OutOfOrder
  • Damage.Mask.OutOfSynch
  • Damage.Mask.UserDefined
  • Damage.Mask.IncompleteContribution
  • Damage.Mask.ContainsIncomplete

The values of enum constants define the bit mask in the damage mask. Mask enum is equivalent to 1<<Value enum.


Construction

Wiki Markup
Usage: {{dmg = xtc.Damage(\[PSDM:_value_\])}}

Arguments:

  • value – complete damage mask as an integer number, if missing then assumed 0

Method value()

Usage: mask = dmg.value()

Returns complete damage mask as integer number.


Method hasDamage()

Usage: result = dmg.hasDamage(value)

Returns true if the corresponding damage bit is set.

Arguments:


Method bits()

Usage: mask = dmg.bits()

Returns damage mask excluding user bits as integer number.


Method userBits()

Usage: mask = dmg.userBits()

Returns user bits of the damage mask as integer number.

...

Panel

Anchor
_pdsdata.xtc.DetInfo
_pdsdata.xtc.DetInfo

Class _pdsdata.xtc.DetInfo

Python wrapper for pdsdata/xtc/DetInfo class. Unlike C++ this class does not inherit from Src class (Src class does not exist in this module) but uses dynamic Python features to implement the same interface as in Src class. In addition to methods described here the class also defines __hash__ and __cmp__ methods based on the content of the object and can be used as a key in the dictionaries.


Anchor
_pdsdata.xtc.DetInfo.Detector
_pdsdata.xtc.DetInfo.Detector

Enum Detector

This enum is an embedded type of DetInfo class. Following enum members are defined currently:

  • DetInfo.Detector.NoDetector
  • DetInfo.Detector.AmoIms
  • DetInfo.Detector.AmoGasdet
  • DetInfo.Detector.AmoETof
  • DetInfo.Detector.AmoITof
  • DetInfo.Detector.AmoMbes
  • DetInfo.Detector.AmoVmi
  • DetInfo.Detector.AmoBps
  • DetInfo.Detector.Camp
  • DetInfo.Detector.EpicsArch
  • DetInfo.Detector.BldEb
  • DetInfo.Detector.SxrBeamline
  • DetInfo.Detector.SxrEndstation
  • DetInfo.Detector.XppSb1Ipm
  • DetInfo.Detector.XppSb1Pim
  • DetInfo.Detector.XppMonPim
  • DetInfo.Detector.XppSb2Ipm
  • DetInfo.Detector.XppSb3Ipm
  • DetInfo.Detector.XppSb3Pim
  • DetInfo.Detector.XppSb4Pim
  • DetInfo.Detector.NumDetector

Anchor
_pdsdata.xtc.DetInfo.Device
_pdsdata.xtc.DetInfo.Device

Enum Device

This enum is an embedded type of DetInfo class. Following enum members are defined currently:

  • DetInfo.Device.NoDevice
  • DetInfo.Device.Evr
  • DetInfo.Device.Acqiris
  • DetInfo.Device.Opal1000
  • DetInfo.Device.TM6740
  • DetInfo.Device.pnCCD
  • DetInfo.Device.Princeton
  • DetInfo.Device.Fccd
  • DetInfo.Device.Ipimb
  • DetInfo.Device.Encoder
  • DetInfo.Device.NumDevice

Construction

Usage: det = xtc.DetInfo(processId, detector, detId, device, devId)

Arguments:

  • processId – integer number
  • detector – one of the PSDM:DetInfo.Detector enum values
  • detId – detector ID as integer number
  • device – one of the PSDM:DetInfo.Device enum values
  • devId – device ID as integer number

Method level()

Usage: lvl = det.level()

Returns enum value of type PSDM:xtc.Level which defines source level.


Method log()

Usage: log = det.log()

Returns logical address of data source as integer number.


Method phy()

Usage: phy = det.phy()

Returns physical address of data source as integer number.


Method processId()

Usage: processId = det.processId()

Returns process ID as integer number.


Method detector()

Usage: detector = det.detector()

Returns detector enum which is a value of PSDM:DetInfo.Detector.


Method device()

Usage: device = det.device()

Returns device enum which is a value of PSDM:DetInfo.Device.


Method detId()

Usage: detId = det.detId()

Returns detector ID as integer number.


Method devId()

Usage: devId = det.devId()

Returns device ID as integer number.

...

Panel

Anchor
_pdsdata.xtc.Dgram
_pdsdata.xtc.Dgram

Class _pdsdata.xtc.Dgram

Python wrapper for pdsdata/xtc/Dgram class.


Construction

Usage: dg = xtc.Dgram(buffer)

One of the ways to create Dgram objects is from a Python buffer objects.

Arguments:

  • buffer – any object that implements buffer interface

Property env

Usage: env = dg.env

Returns the env field as an integer number.


Property seq

Usage: seq = dg.seq

Returns the seq field as an object of type PSDM:xtc.Seq.


Property xtc

Usage: x = dg.xtc

Returns top-level Xtc as object of type PSDM:xtc.Xtc.

...

Panel

Anchor
_pdsdata.xtc.Level
_pdsdata.xtc.Level

Class _pdsdata.xtc.Level

Python wrapper for pdsdata/xtc/Level class. C++ class does not define any data members or methods, it only defines single enum type. C++ cannot be instantiated in any meaningful way. Python class in addition to defining corresponding enum constants can also be instantiated, the instances are regular integer numbers with additional printing enhancements.


Anchor
_pdsdata.xtc.Level.Type
_pdsdata.xtc.Level.Type

Enum Type

Unlike other enum types which create separate new type inside original Python type, the enums in Level class are defined directly in the class. Known enums:

  • Level.Control
  • Level.Source
  • Level.Segment
  • Level.Event
  • Level.Recorder
  • Level.Observer
  • Level.Reporter
  • Level.NumberOfLevels

Construction

Usage: lvl = xtc.Level(number)

Arguments:

  • number – any of the above enums can be used

Method __str__

Usage: s = str(lvl)

Returns a name of the corresponding enum.


Method __repr__

Usage: s = repr(lvl)

Returns a string in the form "<Level(num):name>" where num and name are the value and the name of the corresponding enum.

...

Panel

Anchor
_pdsdata.xtc.ProcInfo
_pdsdata.xtc.ProcInfo

Class _pdsdata.xtc.ProcInfo

Python wrapper for pdsdata/xtc/ProcInfo class. Unlike C++ this class does not inherit from Src class (Src class does not exist in this module) but uses dynamic Python features to implement the same interface as in Src class. In addition to methods described here the class also defines __hash__ and __cmp__ methods based on the content of the object and can be used as a key in the dictionaries.


Construction

Usage: proc = xtc.ProcInfo(level, processId, ipAddr)

Arguments:

  • level – instance of PSDM:xtc.Level type
  • processId – integer number
  • ipAddr – IP address of the host as integer number

Method level()

Usage: lvl = proc.level()

Returns enum value of type PSDM:xtc.Level which defines source level.


Method log()

Usage: log = proc.log()

Returns logical address of data source as integer number.


Method phy()

Usage: phy = proc.phy()

Returns physical address of data source as integer number.


Method processId()

Usage: processId = proc.processId()

Returns process ID as integer number.


Method ipAddr()

Usage: ipAddr = proc.ipAddr()

Returns host IP address as an integer number.

...

Panel

Anchor
_pdsdata.xtc.Sequence
_pdsdata.xtc.Sequence

Class _pdsdata.xtc.Sequence

Python wrapper for pdsdata/xtc/Sequence class.


Anchor
_pdsdata.xtc.Sequence.Type
_pdsdata.xtc.Sequence.Type

Enum Type

This enum is an embedded type of Sequence class. Following enum members are defined currently:

  • Sequence.Type.Event
  • Sequence.Type.Occurrence
  • Sequence.Type.Marker

Construction

This class cannot be instantiated directly, it is instantiated by some other classes, e.g. by Dgram.seq property.


Method type()

Usage: type = seq.type()

Returns the type of this sequence, one of PSDM:Sequence.Type values.


Method service()

Usage: svc = seq.service()

Returns the transition type as object of PSDM:xtc.TransitionId type.


Method isExtended()

Usage: val = seq.isExtended()

Returns True for extended sequence.


Method isEvent()

Usage: val = seq.isEvent()

Returns True for event sequence.


Method clock()

Usage: clock = seq.clock()

Returns clock value for sequence as an object of PSDM:xtc.ClockTime type.


Method stamp()

Usage: stamp = seq.stamp()

Returns timestamp value for sequence as an object of PSDM:xtc.TimeStamp type.

...

Panel

Anchor
_pdsdata.xtc.TimeStamp
_pdsdata.xtc.TimeStamp

Class _pdsdata.xtc.TimeStamp

Python wrapper for pdsdata/xtc/TimeStamp class. In addition to methods described here the class also defines __hash__ and __cmp__ methods based on the content of the object and can be used as a key in the dictionaries.


Construction

Wiki Markup
Usage: {{ts = xtc.TimeStamp(_ticks_, _fiducials_, _vector_, \[PSDM:_control_\])}}

Creates new instance of this type. All arguments are of integer type and have the same meaning as in corresponding C++ constructor.


Method ticks()

Usage: ticks = ts.ticks()

Returns the ticks value as integer number.


Method fiducials()

Usage: fiducials = ts.fiducials()

Returns the fiducials value as integer number.


Method control()

Usage: control = ts.control()

Returns the control value as integer number.


Method vector()

Usage: vector = ts.vector()

Returns the vector value as integer number.

...

Panel

Anchor
_pdsdata.xtc.TypeId
_pdsdata.xtc.TypeId

Class _pdsdata.xtc.TypeId

Python wrapper for pdsdata/xtc/TypeId class. In addition to methods described here the class also defines __hash__ and __cmp__ methods based on the content of the object and can be used as a key in the dictionaries.


Anchor
_pdsdata.xtc.TypeId.Type
_pdsdata.xtc.TypeId.Type

Enum Type

This enum is an embedded type of TypeId class. Following enum members are defined currently:

  • TypeId.Type.Any
  • TypeId.Type.Id_Xtc
  • TypeId.Type.Id_Frame
  • TypeId.Type.Id_AcqWaveform
  • TypeId.Type.Id_AcqConfig
  • TypeId.Type.Id_TwoDGaussian
  • TypeId.Type.Id_Opal1kConfig
  • TypeId.Type.Id_FrameFexConfig
  • TypeId.Type.Id_EvrConfig
  • TypeId.Type.Id_TM6740Config
  • TypeId.Type.Id_ControlConfig
  • TypeId.Type.Id_pnCCDframe
  • TypeId.Type.Id_pnCCDconfig
  • TypeId.Type.Id_Epics
  • TypeId.Type.Id_FEEGasDetEnergy
  • TypeId.Type.Id_EBeam
  • TypeId.Type.Id_PhaseCavity
  • TypeId.Type.Id_PrincetonFrame
  • TypeId.Type.Id_PrincetonConfig
  • TypeId.Type.Id_EvrData
  • TypeId.Type.Id_FrameFccdConfig
  • TypeId.Type.Id_FccdConfig
  • TypeId.Type.Id_IpimbData
  • TypeId.Type.Id_IpimbConfig
  • TypeId.Type.Id_EncoderData
  • TypeId.Type.Id_EncoderConfig
  • TypeId.Type.Id_EvrIOConfig
  • TypeId.Type.Id_PrincetonInfo
  • TypeId.Type.Id_CspadElement
  • TypeId.Type.Id_CspadConfig
  • TypeId.Type.Id_IpmFexConfig
  • TypeId.Type.Id_IpmFex
  • TypeId.Type.Id_DiodeFexConfig
  • TypeId.Type.Id_DiodeFex
  • TypeId.Type.Id_PimImageConfig
  • TypeId.Type.NumberOf

Construction

Wiki Markup
Usage: {{typeId = xtc.TypeId(\[_type_, \[PSDM:_version_\]\])}}

Arguments:

  • type – one of the ebove enum values, if missing then Any assumed
  • version – version number, if missing then assumed to be 0

Method value()

Usage: val = typeId.value()

Returns the whole type ID number including version as integer number.


Method id()

Usage: id = typeId.id()

Returns the type ID number without version as enum object of TypeId.Type type.


Method version()

Usage: vers = typeId.version()

Returns the type ID version number as integer number.

...

Panel

Anchor
_pdsdata.xtc.Xtc
_pdsdata.xtc.Xtc

Class _pdsdata.xtc.Xtc

Python wrapper for pdsdata/xtc/Xtc class. In addition to methods described below this class implements Python iterator interface. Instance can be used as iterator only when its contains type is PSDM:TypeId.Type.Id_Xtc.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Property damage

Usage: dmg = xtcObj.damage

Returns damage bitmask as an object of PSDM:xtc.Damage type.


Property src

Usage: src = xtcObj.src

Returns data source object. Depending on the source level the type of the returned object will be one of PSDM:xtc.BldInfo, PSDM:xtc.DetInfo, or PSDM:xtc.ProcInfo.


Property contains

Usage: typeId = xtcObj.contains

Returns the type of the object contained in XTC as object od PSDM:xtc.TypeId type.


Property extent

Usage: size = xtcObj.extent

Returns the extent (total size) of the XTC.


Method sizeofPayload()

Usage: size = xtcObj.sizeofPayload()

Returns the size of payload object.


Method payload()

Usage: obj = xtcObj.payload()

Returns data object. If contains is TypeId.Type.Any it returns None. If contains is TypeId.Type.Id_Xtc it returns PSDM:xtc.XtcIterator object. For other values it returns one of the specific types such as acqiris.ConfigV1.

...

Panel

Anchor
_pdsdata.acqiris.ConfigV1
_pdsdata.acqiris.ConfigV1

Class _pdsdata.acqiris.ConfigV1

Python wrapper for pdsdata/acqiris/ConfigV1 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method nbrConvertersPerChannel()

Usage: num = cfg.nbrConvertersPerChannel()

Returns integer number.


Method channelMask()

Usage: mask = cfg.channelMask()

Returns integer number.


Method nbrChannels()

Usage: num = cfg.nbrChannels()

Returns integer number.


Method nbrBanks()

Usage: num = cfg.nbrBanks()

Returns integer number.


Method horiz()

Usage: hconfig = cfg.horiz()

Returns object of acqiris.HorizV1 type.


Method trig()

Usage: trig = cfg.trig()

Returns object of PSDM:acqiris.TrigV1 type.


Method vert()

Usage: vconfig = cfg.vert(channel)

Returns object of PSDM:acqiris.VertV1 type.

Arguments:

  • channel – channel number

...

Panel

Anchor
_pdsdata.acqiris.DataDescV1
_pdsdata.acqiris.DataDescV1

Class _pdsdata.acqiris.DataDescV1

Python wrapper for pdsdata/acqiris/DataDescV1 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method nbrSamplesInSeg()

Usage: nsampl = dd.nbrSamplesInSeg()

Returns integer number.


Method nbrSegments()

Usage: nseg = dd.nbrSegments()

Returns integer number.


Method indexFirstPoint()

Usage: idx = dd.indexFirstPoint()

Returns integer number.


Method timestamp()

Usage: ts = dd.timestamp(segment)

Returns object of PSDM:acqiris.TimestampV1 type.

Arguments:

  • segment - segment number

Method waveform()

Usage: wf = dd.waveform(hconfig)

Returns waveform array of numpy.ndarray type.

Arguments:


Method nextChannel()

Usage: nextdd = dd.nextChannel(hconfig)

Returns data object of PSDM:acqiris.DataDescV1 type for next channel or None after the last channel.

Arguments:

...

Panel

Anchor
_pdsdata.acqiris.HorizV1
_pdsdata.acqiris.HorizV1

Class _pdsdata.acqiris.HorizV1

Python wrapper for pdsdata/acqiris/HorizV1 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method sampInterval()

Usage: interval = hconfig.sampInterval()

Returns floating number.


Method delayTime()

Usage: delay = hconfig.delayTime()

Returns floating number.


Method nbrSamples()

Usage: nsampl = hconfig.nbrSamples()

Returns integer number.


Method nbrSegments()

Usage: nseg = hconfig.nbrSegments()

Returns integer number.

...

Panel

Anchor
_pdsdata.camera.FrameFexConfigV1
_pdsdata.camera.FrameFexConfigV1

Class _pdsdata.camera.FrameFexConfigV1

Python wrapper for pdsdata/camera/FrameFexConfigV1 class.


Anchor
_pdsdata.camera.FrameFexConfigV1.Forwarding
_pdsdata.camera.FrameFexConfigV1.Forwarding

Enum Forwarding

This enum is an embedded type of FrameFexConfigV1 class. Following enum members are defined currently:

  • FrameFexConfigV1.Forwarding.NoFrame
  • FrameFexConfigV1.Forwarding.FullFrame
  • FrameFexConfigV1.Forwarding.RegionOfInterest

Anchor
_pdsdata.camera.FrameFexConfigV1.Processing
_pdsdata.camera.FrameFexConfigV1.Processing

Enum Processing

This enum is an embedded type of FrameFexConfigV1 class. Following enum members are defined currently:

  • FrameFexConfigV1.Processing.NoProcessing
  • FrameFexConfigV1.Forwarding.GssFullFrame
  • FrameFexConfigV1.Forwarding.GssRegionOfInterest
  • FrameFexConfigV1.Forwarding.GssThreshold

Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method forwarding()

Usage: val = config.forwarding()

Returns forwarding policy for frame data as enum FrameFexConfigV1.Forwarding.


Method forward_prescale()

Usage: val = config.forward_prescale()

Returns prescale of events with forwarded frames as integer number.


Method processing()

Usage: val = config.processing()

Returns algorithm to apply to frames to produce processed output as enum FrameFexConfigV1.Processing.


Method roiBegin()

Usage: coord = config.roiBegin()

Returns coordinates of start of rectangular region of interest (inclusive) as PSDM:camera.FrameCoord.


Method roiEnd()

Usage: coord = config.roiEnd()

Returns coordinates of finish of rectangular region of interest (exclusive) as PSDM:camera.FrameCoord.


Method threshold()

Usage: val = config.threshold()

Returns pixel data threshold value to apply in processing as integer number.


Method number_of_masked_pixels()

Usage: val = config.number_of_masked_pixels()

Returns count of masked pixels to exclude from processing as integer number.


Method masked_pixel_coordinates()

Usage: list = config.masked_pixel_coordinates()

Returns Python list of masked pixel coordinates, items in the list have type PSDM:camera.FrameCoord.


Method size()

Usage: size = config.size()

Returns size of this structure (including appended masked pixel coordinates).

...

Panel

Anchor
_pdsdata.camera.FrameV1
_pdsdata.camera.FrameV1

Class _pdsdata.camera.FrameV1

Python wrapper for pdsdata/camera/FrameV1 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method width()

Usage: val = frame.width()

Returns number of pixels in a row.


Method height()

Usage: val = frame.height()

Returns number of pixels in a column.


Method depth()

Usage: val = frame.depth()

Returns number of bits per pixel.


Method depth_bytes()

Usage: val = frame.depth_bytes()

Returns number of bytes per pixel.


Method offset()

Usage: val = frame.offset()

Returns fixed offset/pedestal value of pixel data.


Method data_size()

Usage: val = frame.data_size()

Returns fixed offset/pedestal value of pixel data.


Method data()

Wiki Markup
Usage: {{val = frame.data(\[PSDM:_writable_=False\])}}

Returns pixel data as NumPy array, if optional argument is True then array is writable.

Arguments:

  • writable - if True then returned data can be updated in-place

Method pixel()

Usage: val = frame.pixel(x, y)

Returns individual pixel datum given coordinates (x, y).

...

Panel

Anchor
_pdsdata.control.ConfigV1
_pdsdata.control.ConfigV1

Class _pdsdata.control.ConfigV1

Python wrapper for pdsdata/control/ConfigV1 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method uses_duration()

Usage: val = config.uses_duration()

Returns Boolean value.


Method uses_events()

Usage: val = config.uses_events()

Returns Boolean value.


Method duration()

Usage: clock = config.duration()

Returns value of PSDM:xtc.ClockTime type.


Method events()

Usage: val = config.events()

Returns number of events.


Method npvControls()

Usage: val = config.npvControls()

Returns number of PVControls.


Method npvMonitors()

Usage: val = config.npvMonitors()

Returns number of PVMonitors.


Method size()

Usage: val = config.size()

Returns total data size.


Method pvControl()

Usage: val = config.pvControl(index)

Returns PSDM:PVControl for a given index.


Method pvMonitor()

Usage: val = config.pvMonitor(index)

Returns PSDM:PVMonitor for a given index.

...

Panel

Anchor
_pdsdata.cspad.ConfigV1
_pdsdata.cspad.ConfigV1

Class _pdsdata.cspad.ConfigV1

Python wrapper for pdsdata/cspad/ConfigV1 class.


Anchor
_pdsdata.cspad.ConfigV1.RunModes
_pdsdata.cspad.ConfigV1.RunModes

Enum RunModes

This enum is an embedded type of ConfigV1 class. Following enum members are defined currently:

  • ConfigV1.RunModes.NoRunning
  • ConfigV1.RunModes.RunButDrop
  • ConfigV1.RunModes.RunAndSendToRCE
  • ConfigV1.RunModes.RunAndSendTriggeredByTTL
  • ConfigV1.RunModes.ExternalTriggerSendToRCE
  • ConfigV1.RunModes.ExternalTriggerDrop
  • ConfigV1.RunModes.NumberOfRunModes

Class constants

  • ConfigV1.MaxQuadsPerSensor

Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method quads()

Usage: val = config.quads()

Returns list of the objects of type PSDM:_pdsdata.cspad.ConfigV1QuadReg.


Method numQuads()

Usage: val = config.numQuads()

Returns number of quadrants as integer number.


Method tdi()

Usage: val = config.tdi()

Returns integer number.


Method quadMask()

Usage: val = config.quadMask()

Returns integer number.


Method runDelay()

Usage: val = config.runDelay()

Returns integer number.


Method eventCode()

Usage: val = config.eventCode()

Returns integer number.


Method inactiveRunMode()

Usage: val = config.inactiveRunMode()

Returns PSDM:RunModes enum value.


Method activeRunMode()

Usage: val = config.activeRunMode()

Returns PSDM:RunModes enum value.


Method payloadSize()

Usage: val = config.payloadSize()

Returns integer number.


Method badAsicMask0()

Usage: val = config.badAsicMask0()

Returns integer number.


Method badAsicMask1()

Usage: val = config.badAsicMask1()

Returns integer number.


Method asicMask()

Usage: val = config.asicMask()

Returns integer number.


Method numAsicsRead()

Usage: val = config.numAsicsRead()

Returns integer number.


Method concentratorVersion()

Usage: val = config.concentratorVersion()

Returns integer number.

...

Panel

Anchor
_pdsdata.cspad.ConfigV1QuadReg
_pdsdata.cspad.ConfigV1QuadReg

Class _pdsdata.cspad.ConfigV1QuadReg

Python wrapper for pdsdata/cspad/ConfigV1QuadReg class.


Anchor
_pdsdata.cspad.ConfigV1QuadReg.DataModes
_pdsdata.cspad.ConfigV1QuadReg.DataModes

Enum DataModes

This enum is an embedded type of ConfigV1QuadReg class. Following enum members are defined currently:

  • ConfigV1QuadReg.DataModes.normal
  • ConfigV1QuadReg.DataModes.shiftTest
  • ConfigV1QuadReg.DataModes.testData
  • ConfigV1QuadReg.DataModes.reserved

Class constants

  • ConfigV1QuadReg.TwoByTwosPerQuad

Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method shiftSelect()

Usage: val = config.shiftSelect()

Returns list of integer numbers.


Method edgeSelect()

Usage: val = config.edgeSelect()

Returns list of integer numbers.


Method readClkSet()

Usage: val = config.readClkSet()

Returns integer number.


Method readClkHold()

Usage: val = config.readClkHold()

Returns integer number.


Method dataMode()

Usage: val = config.dataMode()

Returns PSDM:DataModes enum value.


Method prstSel()

Usage: val = config.prstSel()

Returns integer number.


Method acqDelay()

Usage: val = config.acqDelay()

Returns integer number.


Method intTime()

Usage: val = config.intTime()

Returns integer number.


Method digDelay()

Usage: val = config.digDelay()

Returns integer number.


Method ampIdle()

Usage: val = config.ampIdle()

Returns integer number.


Method injTotal()

Usage: val = config.injTotal()

Returns integer number.


Method rowColShiftPer()

Usage: val = config.rowColShiftPer()

Returns integer number.


Method readOnly()

Usage: val = config.readOnly()

Returns object of type PSDM:_pdsdata.cspad.CsPadReadOnlyCfg.


Method ro()

Usage: val = config.ro()

Equivalent to config.readOnly().


Method dp()

Usage: val = config.dp()

Returns object of type PSDM:_pdsdata.cspad.CsPadDigitalPotsCfg.


Method gm()

Usage: val = config.gm()

Returns object of type PSDM:_pdsdata.cspad.CsPadGainMapCfg.

...

Panel

Anchor
_pdsdata.cspad.CsPadGainMapCfg
_pdsdata.cspad.CsPadGainMapCfg

Class _pdsdata.cspad.CsPadGainMapCfg

Python wrapper for pdsdata/cspad/CsPadGainMapCfg class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method map()

Usage: val = config.map()

Returns 2-dimensional array of size ColumnsPerASIC x MaxRowsPerASIC (These constants are defined in PSDM:_pdsdata.cspad.ElementV1 class).


Property gainMap

Usage: val = config.gainMap

Returns the same array as map() method above.

...

Panel

Anchor
_pdsdata.cspad.ElementV1
_pdsdata.cspad.ElementV1

Class _pdsdata.cspad.ElementV1

Python wrapper for pdsdata/cspad/ElementV1 class.


Class constants

  • ElementV1.ColumnsPerASIC
  • ElementV1.MaxRowsPerASIC

Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method virtual_channel()

Usage: val = elem.virtual_channel()

Returns integer number.


Method lane()

Usage: val = elem.lane()

Returns integer number.


Method tid()

Usage: val = elem.tid()

Returns integer number.


Method acq_count()

Usage: val = elem.acq_count()

Returns integer number.


Method op_code()

Usage: val = elem.op_code()

Returns integer number.


Method quad()

Usage: val = elem.quad()

Returns integer number.


Method seq_count()

Usage: val = elem.seq_count()

Returns integer number.


Method ticks()

Usage: val = elem.ticks()

Returns integer number.


Method fiducials()

Usage: val = elem.fiducials()

Returns integer number.


Method frame_type()

Usage: val = elem.frame_type()

Returns integer number.


Method sb_temp()

Usage: val = elem.sb_temp(index)

Returns integer number, index is a number from 0 to 3.


Method next()

Usage: val = elem.next(config)

Returns next element, config is an object of type _pdsdata.cspad.ConfigV1 type. Total number of elements is given by config object's numQuads() method.


Method data()

Usage: val = elem.data(config)

Returns data array, config is an object of type PSDM:_pdsdata.cspad.ConfigV1 type. Dimensions of array are nAsic/2 x ColumnsPerASIC x MaxRowsPerASIC x 2, nAsic is the number returned by config object's numAsicsRead() method.


Method pixel()

Usage: val = elem.pixel(asic, column, row)

Returns value of a given pixel.

...

Panel

Anchor
_pdsdata.epics.dbr_type_is_CTRL
_pdsdata.epics.dbr_type_is_CTRL

Function _pdsdata.epics.dbr_type_is_CTRL()

Usage: val = epics.dbr_type_is_CTRL(data)

Returns true if the EPICS type constant of the data object is one of DBR_CTRL_<TYPE> constants. It also means that the data object itself has PSDM:epics.EpicsPvCtrl type.

...

Panel

Anchor
_pdsdata.epics.dbr_type_is_TIME
_pdsdata.epics.dbr_type_is_TIME

Function _pdsdata.epics.dbr_type_is_TIME()

Usage: val = epics.dbr_type_is_TIME(data)

Returns true if the EPICS type constant of the data object is one of DBR_TIME_<TYPE> constants. It also means that the data object itself has PSDM:epics.EpicsPvTime type.

...

Panel

Array _pdsdata.epics.epicsAlarmConditionStrings

Wiki Markup
Usage: {{str = epics.epicsAlarmConditionStrings\[PSDM:_status_\]}}

Stores string representation of the EPICS status codes.

...

Panel

Array _pdsdata.epics.epicsAlarmSeverityStrings

Wiki Markup
Usage: {{str = epics.epicsAlarmSeverityStrings\[PSDM:_severity_\]}}

Stores string representation of the EPICS severity codes.

...

Panel

Anchor
_pdsdata.epics.EpicsPvTime
_pdsdata.epics.EpicsPvTime

Class _pdsdata.epics.EpicsPvTime

Python wrapper for pdsdata/epics/EpicsPvTime<T> classes.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Property iPvId

Usage: val = data.iPvId

Returns PV ID as integer number.


Property iDbrType

Usage: val = data.iDbrType

Returns one of the DBR_CTRL_<TYPE> constants.


Property iNumElements

Usage: val = data.iNumElements

Returns size of PV array.


Property status

Usage: val = data.status

Returns status as integer number. Value can be used as an index into epics.epicsAlarmConditionStrings list. Status 0 means success.


Property severity

Usage: val = data.severity

Returns severity as integer number. Value can be used as an index into epics.epicsAlarmSeverityStrings list. Severity 0 means success.


Property stamp

Usage: val = data.stamp

EPICS timestamp value of type PSDM:epics.epicsTimeStamp.


Property value

Usage: val = data.value

PV value, always a single value, for arrays it is first element. Type of the value is determined by PV type.


Property values

Usage: val = data.values

List of PV values of size data.iNumElements. Type of the values is determined by PV type.

...

Panel

Anchor
_pdsdata.epics.epicsTimeStamp
_pdsdata.epics.epicsTimeStamp

Class _pdsdata.epics.epicsTimeStamp

Python wrapper for pdsdata/epics/epicsTimeStamp class. In addition to methods described here the class also defines __hash__ and __cmp__ methods based on the content of the object and can be used as a key in the dictionaries.


Construction

Wiki Markup
Usage: {{ts = epics.epicsTimeStamp(\[_sec_, \[PSDM:_nsec_\]\])}}

Arguments:

  • sec – number of seconds since Jan 1, 1990 00:00
  • nsec – nanoseconds within second

Property secPastEpoch

Usage: val = ts.secPastEpoch

Returns number of seconds since Jan 1, 1990 00:00.


Property nsec

Usage: val = ts.nsec

Returns nanoseconds within second.

...

Panel

Anchor
_pdsdata.evr.ConfigV1
_pdsdata.evr.ConfigV1

Class _pdsdata.evr.ConfigV1

Python wrapper for pdsdata/evr/ConfigV1 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method npulses()

Usage: val = config.npulses()

Returns integer number.


Method pulse()

Usage: val = config.pulse(index)

Returns object of PSDM:evr.PulseConfig type.


Method noutputs()

Usage: val = config.noutputs()

Returns integer number.


Method output_map()

Usage: val = config.output_map(index)

Returns object of PSDM:evr.OutputMap type.


Method size()

Usage: val = config.size()

Returns total size of the object.

...

Panel

Anchor
_pdsdata.evr.ConfigV2
_pdsdata.evr.ConfigV2

Class _pdsdata.evr.ConfigV2

Python wrapper for pdsdata/evr/ConfigV2 class.


Enum RateCode

This enum is an embedded type of ConfigV2 class. Following enum members are defined currently:

  • ConfigV2.RateCode.r120Hz
  • ConfigV2.RateCode.r60Hz
  • ConfigV2.RateCode.r30Hz
  • ConfigV2.RateCode.r10Hz
  • ConfigV2.RateCode.r5Hz
  • ConfigV2.RateCode.r1Hz
  • ConfigV2.RateCode.r0_5Hz
  • ConfigV2.RateCode.Single
  • ConfigV2.RateCode.NumberOfRates

Enum BeamCode

This enum is an embedded type of ConfigV2 class. Following enum members are defined currently:

  • ConfigV2.BeamCode.Off
  • ConfigV2.BeamCode.On

Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method beam()

Usage: val = config.beam()

Returns value of enum ConfigV2.BeamCode.


Method rate()

Usage: val = config.rate()

Returns value of enum ConfigV2.RateCode.


Method opcode()

Usage: val = config.opcode()

Returns integer number.


Method npulses()

Usage: val = config.npulses()

Returns integer number.


Method pulse()

Usage: val = config.pulse(index)

Returns object of PSDM:evr.PulseConfig type.


Method noutputs()

Usage: val = config.noutputs()

Returns integer number.


Method output_map()

Usage: val = config.output_map(index)

Returns object of PSDM:evr.OutputMap type.


Method size()

Usage: val = config.size()

Returns total size of the object.

...

Panel

Anchor
_pdsdata.evr.ConfigV3
_pdsdata.evr.ConfigV3

Class _pdsdata.evr.ConfigV3

Python wrapper for pdsdata/evr/ConfigV3 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method neventcodes()

Usage: val = config.neventcodes()

Returns integer number.


Method eventcode()

Usage: val = config.eventcode(index)

Returns object of PSDM:evr.EventCodeV3 type.


Method npulses()

Usage: val = config.npulses()

Returns integer number.


Method pulse()

Usage: val = config.pulse(index)

Returns object of PSDM:evr.PulseConfigV3 type.


Method noutputs()

Usage: val = config.noutputs()

Returns integer number.


Method output_map()

Usage: val = config.output_map(index)

Returns object of PSDM:evr.OutputMap type.


Method size()

Usage: val = config.size()

Returns total size of the object.

...

Panel

Anchor
_pdsdata.evr.ConfigV4
_pdsdata.evr.ConfigV4

Class _pdsdata.evr.ConfigV4

Python wrapper for pdsdata/evr/ConfigV4 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method neventcodes()

Usage: val = config.neventcodes()

Returns integer number.


Method eventcode()

Usage: val = config.eventcode(index)

Returns object of PSDM:evr.EventCodeV4 type.


Method npulses()

Usage: val = config.npulses()

Returns integer number.


Method pulse()

Usage: val = config.pulse(index)

Returns object of PSDM:evr.PulseConfigV3 type.


Method noutputs()

Usage: val = config.noutputs()

Returns integer number.


Method output_map()

Usage: val = config.output_map(index)

Returns object of PSDM:evr.OutputMap type.


Method size()

Usage: val = config.size()

Returns total size of the object.

...

Panel

Anchor
_pdsdata.evr.DataV3
_pdsdata.evr.DataV3

Class _pdsdata.evr.DataV3

Python wrapper for pdsdata/evr/DataV3 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method numFifoEvents()

Usage: val = config.numFifoEvents()

Returns integer number.


Method fifoEvent()

Usage: val = config.fifoEvent(index)

Returns object of PSDM:evr.DataV3_FIFOEvent type.

...

Panel

Anchor
_pdsdata.evr.IOChannel
_pdsdata.evr.IOChannel

Class _pdsdata.evr.IOChannel

Python wrapper for pdsdata/evr/IOChannel class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method name()

Usage: val = channel.name()

Returns string value.


Method ninfo()

Usage: val = channel.ninfo()

Returns integer value representing the number of info objects.


Method info()

Usage: val = channel.info(index)

Returns PSDM:xtc.DetInfo object.

Arguments:

  • index – info object index, non-negative number below ninfo() value.

...

Panel

Anchor
_pdsdata.evr.IOConfigV1
_pdsdata.evr.IOConfigV1

Class _pdsdata.evr.IOConfigV1

Python wrapper for pdsdata/evr/IOConfigV1 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method conn()

Usage: val = config.conn()

Returns PSDM:evr.OutputMap.Conn enumeration value.


Method nchannels()

Usage: val = config.nchannels()

Returns integer value representing number of channels.


Method channel()

Usage: val = config.channel(index)

Returns PSDM:evr.IOChannel object for given index.

Arguments:

  • index – channel index, non-negative number below nchannels() value.

...

Panel

Anchor
_pdsdata.lusi.IpmFexConfigV1
_pdsdata.lusi.IpmFexConfigV1

Class _pdsdata.lusi.IpmFexConfigV1

Python wrapper for pdsdata/lusi/IpmFexConfigV1 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Property diode

Usage: val = obj.diode

Returns list of PSDM:_pdsdata.lusi.DiodeFexConfigV1 objects.


Property xscale

Usage: val = obj.xscale

Returns floating number.


Property yscale

Usage: val = obj.yscale

Returns floating number.

...

Panel

Anchor
_pdsdata.opal1k.ConfigV1
_pdsdata.opal1k.ConfigV1

Class _pdsdata.opal1k.ConfigV1

Python wrapper for pdsdata/opal1k/ConfigV1 class.


Constants

  • LUT_Size
  • Row_Pixels
  • Column_Pixels

Enum Depth

This enum is an embedded type of ConfigV1 class. Following enum members are defined currently:

  • ConfigV1.Depth.Eight_bit
  • ConfigV1.Depth.Ten_bit
  • ConfigV1.Depth.Twelve_bit

Enum Binning

This enum is an embedded type of ConfigV1 class. Following enum members are defined currently:

  • ConfigV1.Binning.x1
  • ConfigV1.Binning.x2
  • ConfigV1.Binning.x4
  • ConfigV1.Binning.x8

Enum Mirroring

This enum is an embedded type of ConfigV1 class. Following enum members are defined currently:

  • ConfigV1.Mirroring.None
  • ConfigV1.Mirroring.HFlip
  • ConfigV1.Mirroring.VFlip
  • ConfigV1.Mirroring.HVFlip

Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method black_level()

Usage: val = config.black_level()

Returns offset/pedestal setting for camera (before gain) as integer number.


Method gain_percent()

Usage: val = config.gain_percent()

Wiki Markup
Returns camera gain setting in percentile (\[PSDM:100-3200\] = \[PSDM:1x-32x\]) as integer number.


Method output_offset()

Usage: val = config.output_offset()

Returns offset/pedestal value in pixel counts as integer number.


Method output_resolution()

Usage: val = config.output_resolution()

Returns bit-depth of pixel counts as enum ConfigV1.Depth.


Method output_resolution_bits()

Usage: val = config.output_resolution_bits()

Returns bit-depth of pixel counts (in actual bits).


Method vertical_binning()

Usage: val = config.vertical_binning()

Returns vertical re-binning of output (consecutive rows summed) as enum ConfigV1.Binning.


Method output_mirroring()

Usage: val = config.output_mirroring()

Returns geometric transformation of the image as enum ConfigV1.Mirroring.


Method vertical_remapping()

Usage: val = config.vertical_remapping()

Returns Boolean, true: remap the pixels to appear in natural geometric order (left->right, top->bottom), false: pixels appear on dual taps from different rows (left->right, top->bottom) alternated with (left->right, bottom->top) pixel by pixel.


Method defect_pixel_correction_enabled()

Usage: val = config.defect_pixel_correction_enabled()

Returns Boolean value.


Method output_lookup_table_enabled()

Usage: val = config.output_lookup_table_enabled()

Returns Boolean value.


Method output_lookup_table()

Usage: val = config.output_lookup_table()

Returns output lookup table as NumPy array, elements of array are unsigned numbers.


Method number_of_defect_pixels()

Usage: val = config.number_of_defect_pixels()

Returns defective pixel count.


Method defect_pixel_coordinates()

Usage: val = config.defect_pixel_coordinates()

Returns list of defective pixel coordinates, elements of the list have type PSDM:camera.FrameCoord.


Method size()

Usage: val = config.size()

Returns total size of this structure.

...

Panel

Anchor
_pdsdata.pnccd.FrameV1
_pdsdata.pnccd.FrameV1

Class _pdsdata.pnccd.FrameV1

Python wrapper for pdsdata/pnCCD/FrameV1 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method specialWord()

Usage: val = frame.specialWord()

Returns integer number.


Method frameNumber()

Usage: val = frame.frameNumber()

Returns integer number.


Method timeStampHi()

Usage: val = frame.timeStampHi()

Returns integer number.


Method timeStampLo()

Usage: val = frame.timeStampLo()

Returns integer number.


Method next()

Usage: val = frame.next(config)

Returns next frame object or None.

Arguments:


Method data()

Usage: val = frame.data(config)

Returns frame data as NumPy 2-dimensional array of integers of size 512x512.

Arguments:


Method sizeofData()

Usage: val = frame.sizeofData(config)

Returns integer number.

Arguments:

...

Anchor
_pdsdata.princeton
_pdsdata.princeton

...

Panel

Anchor
_pdsdata.princeton.FrameV1
_pdsdata.princeton.FrameV1

Class _pdsdata.princeton.FrameV1

Python wrapper for pdsdata/princeton/FrameV1 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method shotIdStart()

Usage: val = config.shotIdStart()

Returns integer number.


Method readoutTime()

Usage: val = config.readoutTime()

Returns floating number.


Method data()

Usage: val = config.data(config)

Returns frame data as NumPy 2-dimensional array of integers, size is determined by the configuration object.

Arguments:

...

Panel

Anchor
_pdsdata.princeton.InfoV1
_pdsdata.princeton.InfoV1

Class _pdsdata.princeton.InfoV1

Python wrapper for pdsdata/princeton/InfoV1 class.


Construction

This class cannot be instantiated directly, methods of other classes return instances of this type.


Method temperature()

Usage: val = info.temperature()

Returns floating number.

...

This package is a user-level interface to lower-level PSDM:_pdsdata package. It repeats the module structure of _pdsdata and defines the same classes but shields user from unnecessary details present in _pdsdata. In many cases pypdsdata imports the class from _pdsdata without any changes. Documentation below only describes cases when pypdsdata changes or extends the corresponding _pdsdata types, for unchanged types consult corresponding _pdsdata documentation.

...

Panel

Anchor
pypdsdata.acqiris.DataDescV1
pypdsdata.acqiris.DataDescV1

Class pypdsdata.acqiris.DataDescV1

This class overrides several methods in the corresponding PSDM:_pdsdata.acqiris.DataDescV1 class to simplify user API.


Construction

Usage: dd = DataDescV1(orig, hcfg, vcfg)

Arguments:


Method nbrSamplesInSeg()

Usage: nsampl = dd.nbrSamplesInSeg()

Returns integer number.


Method nbrSegments()

Usage: nseg = dd.nbrSegments()

Returns integer number.


Method timestamp()

Usage: ts = dd.timestamp(segment)

Returns object of PSDM:acqiris.TimestampV1 type.

Arguments:

  • segment - segment number

Method waveform()

Usage: wf = dd.waveform()

Returns waveform array of numpy.ndarray type.


Method timestamps()

Usage: ts = dd.timestamps()

Returns NumPy array of timestamps (floating numbers). First element of array is always 0, other elements are equidistant with the distance and number of intervals determined by PSDM:acqiris.HorizV1 object.

...

Anchor
pypdsdata.cspad
pypdsdata.cspad

...

Panel

Anchor
pypdsdata.cspad.ElementV1
pypdsdata.cspad.ElementV1

Class pypdsdata.cspad.ElementV1

This class overrides several methods in the corresponding PSDM:_pdsdata.cspad.ElementV1 class to simplify user API. It also changes shape of the data array returned from data() method.


Class constants

  • ElementV1.ColumnsPerASIC
  • ElementV1.MaxRowsPerASIC

Construction

Usage: elem = ElementV1(quad, config)

Arguments:


Method virtual_channel()

Usage: val = elem.virtual_channel()

Returns integer number.


Method lane()

Usage: val = elem.lane()

Returns integer number.


Method tid()

Usage: val = elem.tid()

Returns integer number.


Method acq_count()

Usage: val = elem.acq_count()

Returns integer number.


Method op_code()

Usage: val = elem.op_code()

Returns integer number.


Method quad()

Usage: val = elem.quad()

Returns integer number.


Method seq_count()

Usage: val = elem.seq_count()

Returns integer number.


Method ticks()

Usage: val = elem.ticks()

Returns integer number.


Method fiducials()

Usage: val = elem.fiducials()

Returns integer number.


Method frame_type()

Usage: val = elem.frame_type()

Returns integer number.


Method sb_temp()

Usage: val = elem.sb_temp(index)

Returns integer number, index is a number from 0 to 3.


Method data()

Usage: val = elem.data()

Returns data array. Dimensions of array are nAsic x MaxRowsPerASIC x ColumnsPerASIC, nAsic is the number returned by config object's numAsicsRead() method.


Method pixel()

Usage: val = elem.pixel(asic, column, row)

Returns value of a given pixel.

...

Panel

Anchor
pypdsdata.pnccd.FrameV1
pypdsdata.pnccd.FrameV1

Class pypdsdata.pnccd.FrameV1

This class overrides several methods in the corresponding PSDM:_pdsdata.pnccd.FrameV1 class to simplify user API. In particular it merges four images from PnCCD into one larger image.


Construction

Usage: frame = FrameV1(frames, config)

Arguments:


Method specialWord()

Usage: val = frame.specialWord()

Returns integer number.


Method frameNumber()

Usage: val = frame.frameNumber()

Returns integer number.


Method timeStampHi()

Usage: val = frame.timeStampHi()

Returns integer number.


Method timeStampLo()

Usage: val = frame.timeStampLo()

Returns integer number.


Method data()

Usage: val = frame.data()

Returns frame data as NumPy 2-dimensional array of integers of size 1024x1024.


Method sizeofData()

Usage: val = frame.sizeofData()

Returns integer number.

...

Panel

Anchor
pypdsdata.princeton.FrameV1
pypdsdata.princeton.FrameV1

Class pypdsdata.princeton.FrameV1

This class overrides several methods in the corresponding PSDM:_pdsdata.princeton.FrameV1 class to simplify user API.


Construction

Usage: frame = FrameV1(frames, config)

Arguments:


Method shotIdStart()

Usage: val = frame.shotIdStart()

Returns integer number.


Method readoutTime()

Usage: val = frame.readoutTime()

Returns floating number.


Method data()

Usage: val = frame.data()

Returns frame data as NumPy 2-dimensional array of integers.