This page was auto-generated from a Jupyter notebook: about.
Problems? Please raise any issues on Github.
About ePSdata¶
21/01/20
Overview¶
- ePolyScat (ePS) is an open-source tool for numerical computation of electron-molecule scattering & photoionization by Lucchese & coworkers. For more details try: 
- Calculation of low-energy elastic cross sections for electron-CF4 scattering, F. A. Gianturco, R. R. Lucchese, and N. Sanna, J. Chem. Phys. 100, 6464 (1994), http://dx.doi.org/10.1063/1.467237 
- Cross section and asymmetry parameter calculation for sulfur 1s photoionization of SF6, A. P. P. Natalense and R. R. Lucchese, J. Chem. Phys. 111, 5344 (1999), http://dx.doi.org/10.1063/1.479794 
 
- ePSproc is an open-source tool for post-processing & visualisation of ePS results, aimed primarily at photoionization studies. - Ongoing documentation is on Read the Docs. 
- Source code is available on Github. 
- For more background, see the software metapaper for the original release of ePSproc (Aug. 2016): ePSproc: Post-processing suite for ePolyScat electron-molecule scattering calculations, on Authorea or arXiv 1611.04043. 
 
- ePSdata is an open-data/open-science collection of ePS + ePSproc results. - ePSdata collects ePS datasets, post-processed via ePSproc (Python) in Jupyter notebooks, for a full open-data/open-science transparent pipeline. 
- ePSdata is currently (Jan 2020) collecting existing calculations from 2010 - 2019, from the femtolabs at NRC, with one notebook per ePS job. 
- In future, ePSdata pages will be automatically generated from ePS jobs (via the ePSman toolset, currently in development), for immediate dissemination to the research community. 
- Source notebooks are available on the Github project pages, and notebooks + datasets via Zenodo repositories (one per dataset). Each notebook + dataset is given a Zenodo DOI for full traceability, and notebooks are versioned on Github. 
- Note: ePSdata may also be linked or mirrored on the existing ePolyScat Collected Results OSF project, but will effectively supercede those pages. 
- All results are released under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 (CC BY-NC-SA 4.0) license, and are part of our ongoing Open Science initiative. 
 

 

Demos¶
For an introduction to ePS and ePSproc, see:
- Sample ePS jobs from the ePolyScat website and manual 
- Demos for ePSproc: 
- :math:beta_{lm}` calculations demo <https://epsproc.readthedocs.io/en/latest/ePSproc_BLM_calc_demo_Sept2019_rst/ePSproc_BLM_calc_demo_Sept2019.html>`__ 
 
(More demos coming soon.)
Workflow¶
The general workflow for photoionization calculations plus post-processing is shown below. This pipeline involves a range of code suites, as shown in the main workflow; some additional details are also illustrated.

The basic ePSproc workflow (from the original software metapaper is shown below: essentially, the ePS output file is parsed for photoionization matrix elements, and ancillary data; the matrix elements are the used to calculate properties of interest, such as photoionziation cross-sections and MF-PADs. For ePSdata, this workflow is applied to each ePS dataset, with a Jupyter notebook as a template. The completed analysis & dataset is then uploaded to Zenodo, and HTML version to ePSdata.

Citation & acknowledgements¶
Each notebook & dataset has a DOI, see the citations page for further details.
Motivation¶
Scientific¶
- Platform development for quantum metrology with photoelectrons; see, for example: 
- Theory and method development. 
- Bridge-building and method unification between theory and experiment. 
- Lowering the barrier to entry for photoionization studies. 
- Sharing and disemination of computational results and data, which would not otherwise be subject to “traditional” publication, and just sit on a hard-drive. 
- General good scientific practice and open science… 
Platform development for quantum metrology with photoelectrons: figures below show existing and new platform schematics. In the former case, theory and experiment are treated separately, and compared at the level of observables; in the latter lower-level comparisons are possible and aid analysis.  
 
Science policy/open science¶
- All things open: open data, open science, open source software. (See further reading below, and also the Open Science Initiative). 
- Reproducibility, and avoiding the reproducibility crises. 
- Transparency, and making full computational results stacks available. 
- Building a community resource. 
Some further reading on these topics, in no particular order:
- Promoting an open research culture. Nosek et. al. (2015). Science, 348(6242), 1422–1425. 
- Publish your computer code: it is good enough. Barnes, N. (2010). Nature, 467(7317), 753. 
For more general discussion, tools and further resources, see, for example:
- Reproducible Research and Data Analysis module at Open Science MOOC (includes many more tools, links and references, many other modules are available too). 

Notes¶
- Web pages are auto-generated from source Jupyter notebooks: please raise any issues on Github. 
- Figures may appear small due to HTML template constraints, but opening in a new window or downloading will provide the high-res source. (This will be fixed at some point in the future…)