Draft document generated by the IDEAS xSDK project.
We are actively soliciting suggestions from the community at https://xsdk.info/policies.
xSDK Community Package Policies
The IDEAS Project xSDK Team
Version 0.5.0, June 27, 2019
A key aspect of work in the IDEAS Scientific Software Productivity Project is developing an Extreme-scale Scientific Software Development Kit (xSDK) — a collection of related and complementary software elements that provide the building blocks, tools, models, processes, and related artifacts for rapid and efficient development of high-quality applications. As an initial step in creating xSDK, we have written the following draft xSDK package community policies to help address challenges in interoperability and sustainability of software developed by diverse groups at different institutions.
Develop a set of xSDK community policies that a software library/framework (henceforth referred to as package)1 must satisfy in order to to be xSDK compatible . The designation of a package being xSDK compatible informs potential users that the package can be easily used with other xSDK libraries and components and thus helps to address issues in long-term sustainability2 and interoperability among packages.
We consider two categories of xSDK packages: xSDK compatible packages and xSDK member packages. We also consider two levels of xSDK compatibility: mandatory policies and recommended policies.
A package will be declared xSDK compatible once the xSDK team has determined that the package satisfies the mandatory xSDK policies listed below. In addition to the required policies, we specify recommended xSDK policies that further help to address issues in software interoperability.
Similarly, a package can become an xSDK member package if (1) it is an xSDK-compatible package, and (2) it uses or can be used by another package in xSDK, and the connecting interface is regularly tested for regressions.
Initially the requirements and process are informally presented; over time, if needed, we can begin to formalize them. Currently, xSDK includes seventeen popular numerical libraries:
and two applications packages:
which satisfy the required policies. Over the longer term, xSDK may expand to incorporate additional packages, depending on community needs and contributions.
xSDK Mandatory Policies
M3. Employ user-provided MPI communicator (no MPI_COMM_WORLD). Don't assume a full MPI 3 implementation without checking. Provide an option to prevent any changes to MPI error-handling if it is changed by default.
xSDK Recommended Policies
In addition to the required xSDK policies listed above, the following capabilities are also recommended.
History of the xSDK Community Policies
The original version of this document was prepared in 2015 by Barry Smith with key input from Roscoe Bartlett and feedback from members of the IDEAS project. Over time, revisions have been introduced based on discussions with the broader computational science community and developers of an expanding collection of xSDK member packages. We thank all xSDK package developers, the IDEAS team, and the scientific computing community for insightful discussion about issues and approaches.
- Changes in version 0.5.0, June 27, 2019:
- Added new policy R7, which recommends the inclusion of various information files in the top directory
- Dropped the requirement to detect MPI 2 features in M3
- Made various editorial changes in M5, M13, M15, and R2 for clarification or to fix typos.
- Changes in version 0.4.0, July 27, 2018:
- Split policy M4 into 2 parts: M4 (portability to common platforms) and new policy R6 (package should document the versions of packages with which it can work on on which it depends). See https://github.com/xsdk-project/xsdk-issues/issues/55
- Revision to M7: language about open source licensing requirements. See https://github.com/xsdk-project/xsdk-issues/issues/56
- New section on history of policies and summary of changes, misc minor edits
- Changes in version 0.3.0, November 6, 2017: added 2 new policies (M15 and M16), changed naming convention to follow xSDK release number, minor typo edits
- Changes in version 0.3, December 2, 2016: clear definition of xSDK member packages, misc minor edits
- Changes in version 0.2, January 28, 2016: minor edit
- Version 0.1, November 10, 2015: original version
Frequently Asked Questions about xSDK
See the xSDK FAQ list.
This material is based upon work supported by the U.S. Department of Energy, Office of Science, Advanced Scientific Computing Research and Biological and Environmental Research programs.
1 For the purpose of this document, the term package refers to a collection of source code (possibly containing C, Fortran, or C++) that can generate zero or more shared or static libraries, zero or more include files, zero or more Fortran modules, and possibly other auxiliary artifacts, including executables, and whose functionality can be used by other packages and by application codes. A software artifact that generates only an executable is, by this definition, not an xSDK package; that is, xSDK packages are libraries, frameworks, and domain components.
2 See, for example, "Self-Sustaining Software" as outlined in http://trac.trilinos.org/wiki/TribitsLifecycleModelOverview#self_sustaining_software.