Metadata-Version: 2.1
Name: gluex.hddm_s
Version: 1.0.7
Summary: methods for reading and writing GlueX simulated event data
Home-page: https://github.com/rjones30/hddm_s
Author: Richard T. Jones
Author-email: "Richard T. Jones" <richard.t.jones@uconn.edu>
Maintainer-email: "Richard T. Jones" <richard.t.jones@uconn.edu>
License: MIT License
Project-URL: Homepage, https://github.com/rjones30/hddm_s
Project-URL: Documentation, https://github.com/rjones30/hddm_s
Project-URL: Repository, https://github.com/rjones30/hddm_s
Project-URL: Issues, https://github.com/rjones30/hddm_s/issues
Project-URL: Changelog, https://github.com/rjones30/hddm_s/issues/main/CHANGELOG.md
Keywords: hddm,GlueX,Gluex,gluex,hdgeant4,hdgeant
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# hddm\_s - i/o library for reading and writing simulated events from the GlueX detector

The hddm\_s module is a python wrapper around the c++ library that implements reading 
and writing of simulated events from the GlueX detector, based on the HDDM event i/o
framework. Every hddm\_s file consists of a plain-text header describing the structure
of the event data contained in the file in xml format known as a hddm template. After
the header follows compressed binary data describing the sequence of simulated events
contained in the file. All files with valid hddm\_s events share a compatible template
indicated by the class="s" attribute in the first line of the file header. All such
files should be readable by this module if they are compliant with the HDDM standard.
For more details on the standard, see https://github.com/rjones30/HDDM.

For details on the hddm\_s API, install hddm\_s and type "pydoc hddm\_s". Here is a 
quickstart example of an analysis tool that reads from hddm\_s input files.

	import hddm\_s
	for rec in hddm_s.istream("http://nod25.phys.uconn.edu:2880/Gluex/simulation" +
	                          "/simsamples/particle_gun-v5.2.0/particle_gun001_019.hddm"):
	   for pe in rec.getPhysicsEvents():
	      print(f"http streaming reader found run {pe.runNo}, event {pe.eventNo}")
	
	for rec in hddm_s.istream("https://nod25.phys.uconn.edu:2843/Gluex/simulation" +
	                          "/simsamples/particle_gun-v5.2.0/particle_gun001_019.hddm"):
	   for pe in rec.getPhysicsEvents():
	      print(f"https streaming reader found run {pe.runNo}, event {pe.eventNo}")
	
	for rec in hddm_s.istream("root://nod25.phys.uconn.edu/Gluex/simulation" +
	                          "/simsamples/particle_gun-v5.2.0/particle_gun001_019.hddm"):
	   for pe in rec.getPhysicsEvents():
	      print(f"xrootd streaming reader run {pe.runNo}, event {pe.eventNo}")
	
