As part of the Data Analytics Framework for XDMoD, this Python package provides API access to the data warehouse of instances of Open XDMoD version ≥10.5.

The package can be installed from PyPI via pip install xdmod-data.

Existing installations can be upgraded via pip install --upgrade xdmod-data.

The package has dependencies on NumPy, Pandas, Plotly, and Requests.

Example usage is documented through Jupyter notebooks in the xdmod-notebooks repository.

Specific versions of this package are compatible with specific versions of Open XDMoD as indicated in the table below.

Use of the Data Analytics Framework requires an API token. To obtain an API token, follow the steps below to obtain an API token from the XDMoD portal.

1. First, if you are not already signed in to the portal, sign in in the top-left corner:

   

2. Next, click the "My Profile" button in the top-right corner:

   

3. The "My Profile" window will appear. Click the "API Token" tab:

   

   Note: If the "API Token" tab does not appear, it means this instance of XDMoD is not configured for the Data Analytics Framework.

4. If you already have an existing token, delete it:

   

5. Click the "Generate API Token" button:

   

6. Copy the token to your clipboard. Make sure to paste it somewhere secure for saving, as you will not be able to see the token again once you close the window:

   

   Note: If you lose your token, simply delete it and generate a new one.

We welcome your feedback and feature requests for the Data Analytics Framework for XDMoD via email: ccr-xdmod-help@buffalo.edu.

For support, please see this page. If you email for support, please include the following:

• xdmod-data version number, obtained by running this Python code:

  from xdmod_data import __version__
  print(__version__)
  

• Operating system version.
• A description of the problem you are experiencing.
• Detailed steps to reproduce the problem.

xdmod-data is released under the GNU Lesser General Public License ("LGPL") Version 3.0. See the LICENSE file for details.

When referencing the Data Analytics Framework for XDMoD, please cite the following publication:

Weeden, A., White, J.P., DeLeon, R.L., Rathsam, R., Simakov, N.A., Saeli, C., and Furlani, T.R. The Data Analytics Framework for XDMoD. SN COMPUT. SCI. 5, 462 (2024). https://doi.org/10.1007/s42979-024-02789-2

When referencing XDMoD, please cite the following publication:

Jeffrey T. Palmer, Steven M. Gallo, Thomas R. Furlani, Matthew D. Jones, Robert L. DeLeon, Joseph P. White, Nikolay Simakov, Abani K. Patra, Jeanette Sperhac, Thomas Yearke, Ryan Rathsam, Martins Innus, Cynthia D. Cornelius, James C. Browne, William L. Barth, Richard T. Evans, "Open XDMoD: A Tool for the Comprehensive Management of High-Performance Computing Resources", Computing in Science & Engineering, Vol 17, Issue 4, 2015, pp. 52-62. DOI:10.1109/MCSE.2015.68