Warning, /DataFormats/Scouting/README.md is written in an unsupported language. File is not indexed.
0001 # DataFormats/Scouting
0002
0003 ## Scouting Data Formats
0004
0005 Any changes to the Scouting data formats must be backwards compatible. In order to ensure the Scouting formats can be read by all future CMSSW releases, there is a `TestRun3ScoutingDataFormats` unit test, which makes use of the `TestReadRun3Scouting` analyzer and the `TestWriteRun3Scouting` producer. The unit test checks that the objects can be read properly from
0006
0007 * a file written by the same release
0008 * files written by (some) earlier releases
0009
0010 If the persistent format of any Scouting data format gets changed in the future, please adjust the `TestReadRun3Scouting` and `TestWriteRun3Scouting` modules accordingly. It is important that every member container has some content in this test. Please also add new files to the [https://github.com/cms-data/DataFormats-Scouting/](https://github.com/cms-data/DataFormats-Scouting/) repository, and update the `TestRun3ScoutingDataFormats` unit test to read the newly created files. There should be one file written with split level 0 and one with split level 99. The file name should contain the version numbers of the data format classes (from classes_def.xml) in alphabetical order (they are in this alphabetical order already in classes_def.xml), the release or pre-release with which it was written and the split level. If the latest file of Run 3 scouting before the update has not been used in data taking, the file can be deleted.
0011
0012 There are analogous tests for Run 2. It is unlikely those formats will change anymore. There will probably be analogous tests added in the future for runs after Run 3 which will need similar maintenance.