Perfdb XML Schema
From PERI
← Performance data repository main page.
Contents |
Overview
The schema language used is mostly RELAX-NG compact syntax (RNC). However, an effort is being made to provide autogenerated XML-Schema (XSD) as well. If you want some more information on how to deal with RELAX-NG, please look at the RELAX-NG tools page.
Subversion repository
The schemas and examples are now (5 Mar 2008) in subversion. The repository is world-readable; to get write permissions contact the peri-db list or Dan Gunter. Assuming you have installed the subversion client library, to check out the entire repository you need only type the following:
svn co https://bosshog.lbl.gov/repos/peridb
Current schemas
Current discussed, used, validated, etc. schemas
- Relax-NG compact syntax: schema.rnc
- XML Schema syntax (2 files): schema.xsd, wsa.xsd
- Validated XML example: example.xml
Experimental schemas
- Reorganized schema with separate run-rules, static/dynamic location, and data sections:
- Earlier version of a general-purpose "data" schema. To keep things modular, this has been combined with the "run rules" schema under a very simple top-level schema. Duplicated types (so far, just the "Identifier") were put in a common schema. Thus we now have 4 separate schemas:
- Top-level schema -- just includes the next two
- Data schema -- this is the new one (PERI-data schema diagram)
- Run rules schema -- almost identical to the one above, but not quite.
- Common schema -- Types duplicated between the data and run rules
- Since it is actually a bit of a pain to combine the 4 schemas above in a way that tools like 'trang' can handle, here is a "combined" schema that flattens out the above into a single file.
- Combined schema -- see description above.
- XML Schema version of combined schema -- In case you want to use it for validation with the XML Schema toolset
Examples
- TAU
- Exported output and original TAU profiles (and program source) Note: the schema has changed a lot, so I suppressed most of the metadata, since it wouldn't validate otherwise. Also, this is a VERY simple example - no callpath data, for example. I will try to generate a more complex example if/when I get time. --Khuck 22:17, 3 March 2008 (PST)
- Prophesy
- Media:Prophesy-db-Jacquard-milc.xml(old) and the new one Media:db-Jacquard-milc.xml Note: I modified the old one based on the latest schema (Hope it is the latest).--Wuxf 10:53, 19 March 2008 (PDT)
- Integrated Performance Monitoring (IPM)
- OLD: A partial example of how the Open|SpeedShop output (as of this writing) might be adapted to use this schema.
Older schemas
- 11/02
- Relax-NG compact syntax: schema.rnc
- 10/29
- 10/19
- 02/28
History
2008-01-22
Changes from 11/02/2007 to the .rnc file:
- changed Timestamp to be either a single time, as before, or a startTime and endTime
- Added a name, version element to the Scheduler element
- Made optional the 'version' part of the NameVersion type
2007-03-09
Media:HPC-DB-ocracoke.xml sample HPC DB export xml file on RENCI BGL
2007-02-28
- schema file (2/28)
- very minor update
Media: Prophesy-db.xml for performance data on 1024 (1024x1) processors on UNC RENCI BlueGene/L
Media:Prophesy-db-Jacquard.xml for performance data on 512 (256x2) processors on NERSC Jacquard
Media:Prophesy-db-DataStar.xml for performance data on 1024 (128x8) processors on SDSC DataStar p655
Media:Prophesy-db-Seaborg.xml for performance data on 1024 (64x16) processors on NERSC Seaborg
2007-02-23
- schema file (2/23)
- Updated relax-ng schema -- experimental
- PerfDMF .xml export (modified from Kevin Huck)
2007-02-21
- schema file (2/21)
- Updated relax-ng schema
- Minimal required information example
- Minimal required information from a run (for discussion)
2007-01-17
Dan 09:50, 17 January 2007 (PST)
Files:
- New: schema file
- Example file 1 -- source code only
- New: Example file 2 -- compilation, instrumentation, and run.
Changes:
- Added 'person' element to the 'run' section
- Moved inputs/outputs into 'run' section
- Added name/version to 'source code'
- Updated example2 and re-validated both examples
2007-01-10
This schema is a refactoring by Dan Gunter of the 2007-01-09 schema. Also included are two example files that together describe a trivial example of compiling a C file on a Mac.
- schema file
- Example file 1 -- source code only
- Example file 2 -- compilation and run.
2007-01-09
This is the schema to be discussed on the telecon on January 9, 2007. It also happens to be the first one!