The python API for photon and neutron simulation codes in the Photon and Neutron Open Science Cloud (PaNOSC).
Installation instructions here
Requires:
python >= 3.8
Simulations provide invaluable insights to plan (before) and understand (after) experiments at neutron and X-ray facilities. A wide set of libraries and programs is already available to simulate neutron and X-ray beams, propagate them through the beamlines, interact with the sample and get data acquired by detectors.
The aim of libpyvinyl is to provide a high level neutron and X-ray simulation API.
With this harmonized user interface we achieve seamless
interoperability of individual simulations thereby facilitating the
concatenation of simulation steps into a simulation pipeline.
The vast differences with respect to parameter
names, unit conventions, configuration syntax, i.e. the user
interface, is, hence, overcome creating a libpyvinyl compliant API
for each simulation software.
The python package libpyvinyl provides a way to harmonize the user interfaces of such simulation codes. It is an object oriented library; its classes define the user interface to simulation codes, simulation parameters and simulation data.
For a given simulation code, e.g. propagation of neutron or photon
beams through a beamline, a new class would have to be defined that
derives from the libpyvinyl classes.
This derived class requires the implementation of certain methods
meant to configure a simulation, launch the simulation code, and
retrieve the output data.
Since the interplay between parametrization, execution, and IO is
already taken care of at the level of libpyvinyl's base classes, the
effort to define a specialized interface (parameters, backengine and
data object) for a new simulation code is rather minimal. This structure
allows integrating simulation codes into simulation pipelines in the
above sense.
This API offers a homogeneous interface to:
Data instance that represents the simulation output data.Three kind of users are the target of this package:
There are currently two projects based on libpyvinyl:
Documentation can be generated as follows using sphinx:
cd doc/
pip install requirements.txt
make html
Please find the development guide here.
This project has received funding from the European Union's Horizon 2020 research and innovation programme under grant agreement No. 823852.
FAQs
The python API for photon and neutron simulation codes in the Photon and Neutron Open Science Cloud (PaNOSC).
We found that libpyvinyl demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.