xdmod-data

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

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

It has dependencies on NumPy, Pandas, Plotly, and Requests.

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

API Token Access

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.

Feedback / Feature Requests

We welcome your feedback and feature requests for the XDMoD Data Analytics Framework via email: [email protected].

Support

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.

License

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

Reference

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