DB Geometry

Complete:

Goal of this page

The main goal of this page is to provide instructions for loading the database geometry objects or payloads into the conditions database. At the end of this process, the AlCaDB conveners will create a new Global Tag pointing to the new payloads.

The master detector description information is in XML files in the Geometry subsystem of every CMSSW release. Various scenarios of the geometry of CMS as described in XML files are loaded into a database and are accessed via the conditions infrastructure. The different sets of XML files (scenarios) are proposed by software developers and physicists responsible for the description of the particular detector configuration.

Some notes about global tags and database tags can be found here: SwGuideNotesAboutTags

Step 1 Gather the Modifications

When development is completed for a scenario, geometry DB payloads can be created and loaded into the Conditions DB. Scripts and programs in CondTools/Geometry/test/writehelpers need to be created to create the big XML file and the reco geometries for the scenario. Typically, sub-detector DPGs are responsible for developing the code to create reco geometry payloads for their detector.

A scenario typically has a number of sub-scenarios that provide Tracker reduced material scenarios. For DD4hep, we currently have the following scenarios:

• Extended2021
• Extended2021FlatMinus05Percent
• Extended2021FlatMinus10Percent
• Extended2021FlatPlus05Percent
• Extended2021FlatPlus10Percent
• Extended2021ZeroMaterial

Step 2 Create the Payloads

Here is the quick recipe.

cmsrel CMSSW_12_5_0_pre2
cd CMSSW_12_5_0_pre2/src
cmsenv
git cms-addpkg CondTools/Geometry
scram b
cd CondTools/Geometry/test
/bin/cp writehelpers/* .
./createExtended2021DD4hepPayloads.sh 125DD4hepV1

The last two steps can be repeated if an error occurs when the payloads are being created.

The argument to the createPayloads script is the tag you want to be used. The first 3 characters specify the release series these payloads are intended to be used with first. "DD4hep" in the middle is the current standard for DD4hep payloads. The last 2 characters are just a version number to be used in case more than one set of payloads is needed. Start with 1 and increment the number for each new set of payloads. The tag must be new and unique.

If everything goes fine you will see output without exception messages and all payloads will have non-zero length.

The createExtended2021DD4hepPayloads script does the following:

1. Reads all the little XML files for the extended scenario and writes one big XML file.
2. Reads the big XML file, converts it to a blob, and writes that the to the local database in the file myfile.db. In parallel rereads the little XML files and fills the DDCompactView and then from that fills the reco parts of the database in myfile.db.
3. Repeats the steps above for each scenario, except the reco parts of the database are only filled once not for each scenario.
4. Splits the different pieces put in to myfile.db into separate database files. These are the payloads.

Here are example payloads from CMSSW_12_4_0_pre2:

-rw-r--r--. 1 cvuosalo    53248 Apr 11 23:44 CSCRECODIGI_Geometry.db
-rw-r--r--. 1 cvuosalo   122880 Apr 11 23:44 CSCRECO_Geometry.db
-rw-r--r--. 1 cvuosalo   204800 Apr 11 23:44 CTRECO_Geometry.db
-rw-r--r--. 1 cvuosalo   684032 Apr 11 23:44 DTRECO_Geometry.db
-rw-r--r--. 1 cvuosalo  2011136 Apr 11 23:44 EBRECO_Geometry.db
-rw-r--r--. 1 cvuosalo   491520 Apr 11 23:44 EERECO_Geometry.db
-rw-r--r--. 1 cvuosalo  2351104 Apr 11 23:44 EPRECO_Geometry.db
-rw-r--r--. 1 cvuosalo   315392 Apr 11 23:44 GEMRECO_Geometry.db
-rw-r--r--. 1 cvuosalo   913408 Apr 11 23:44 GeometryFileExtended2021.db
-rw-r--r--. 1 cvuosalo   917504 Apr 11 23:44 GeometryFileExtended2021FlatMinus05Percent.db
-rw-r--r--. 1 cvuosalo   917504 Apr 11 23:44 GeometryFileExtended2021FlatMinus10Percent.db
-rw-r--r--. 1 cvuosalo   917504 Apr 11 23:44 GeometryFileExtended2021FlatPlus05Percent.db
-rw-r--r--. 1 cvuosalo   917504 Apr 11 23:44 GeometryFileExtended2021FlatPlus10Percent.db
-rw-r--r--. 1 cvuosalo   917504 Apr 11 23:44 GeometryFileExtended2021ZeroMaterial.db
-rw-r--r--. 1 cvuosalo    57344 Apr 11 23:44 HCALParameters_Geometry.db
-rw-r--r--. 1 cvuosalo   806912 Apr 11 23:44 HCALRECO_Geometry.db
-rw-r--r--. 1 cvuosalo   532480 Apr 11 23:44 RPCRECO_Geometry.db
-rw-r--r--. 1 cvuosalo    53248 Apr 11 23:44 TKParameters_Geometry.db
-rw-r--r--. 1 cvuosalo  5210112 Apr 11 23:44 TKRECO_Geometry.db
-rw-r--r--. 1 cvuosalo    53248 Apr 11 23:44 ZDCRECO_Geometry.db

Another local DB file is created:

-rw-r--r--. 1 cvuosalo 17510400 Apr 11 23:44 myfile.db

It is used for testing, and it contains all the other payloads.

Step 3 Test the Payloads

Follow the instructions here DD4hep versus DataBase Validation to test that the payloads are correct and contain only the desired changes.

Step 4 Upload to the Prod Database

Once the payloads have been checked, they can be uploaded to the Prod Condtions DB. Use the uploadConditions.py script in the path to perform the upload. Your user account will require permission to write to the Prod DB, which can be provided by the AlCaDB conveners.

The script takes a payload DB file as an argument. It will prompt the user to create the metadata text file needed for uploading. Next, it will prompt to confirm the input tag. The default value is usually correct. For the next prompt, choose the prod database. At the "since" prompt, just hit Enter (nothing). For the user text, provide a short, explanatory comment about the version of the payload. For the destination tag, you must specify the full name of the input tag, and then hit Enter (nothing) for the second destination tag. The script will then display the metadata file and ask whether to upload to the DB. It will then prompt for your password to authorize the upload.

Here is an example metadata text file:

{
    "destinationDatabase": "oracle://cms_orcon_prod/CMS_CONDITIONS",
    "destinationTags": {
        "XMLFILE_Geometry_121DD4hepV1_Extended2021_mc": {}
    },
    "inputTag": "XMLFILE_Geometry_121DD4hepV1_Extended2021_mc",
    "since": null,
    "userText": "Final 12_1 Run 3 DD4hep extended geometry description"
}

To speed up uploading many payloads, you can create the metadata files manually in advance if you know the format. The file name matches the payload DB file, except it ends in "txt" instead of "db".

Step 5 In the Conditions DB, add the new tags to the queues

After uploading, the payloads are in the Condtions DB, but nothing knows about them. The next step is to add the tags for the payloads to queues. Go to the Conditions DB Browser service. In the Global Tags dropdown, click on "Request Tag for GT". In the "Tag" field, type the name of the payload tag. Then select the correct record name in the "Record" field (see below for record names for each type of payload). The "Label" field is blank for the reco geometries but must be filled in for the extended geometry description payloads (the big XML file). The "Label" values are as follows, depending on the scenario:

Extended
ZeroMaterial
FlatMinus05Percent
FlatMinus10Percent
FlatPlus05Percent
FlatPlus10Percent 

Note that multiple tags can be entered by clicking "Add more tags". An explanatory comment should be put into the "Comment" field.

In the typical case, the tags are added to six queues. Here is an example list:

 123X_mcRun3_2021_design_Queue
 123X_mcRun3_2021_realistic_HI_Queue
 123X_mcRun3_2021cosmics_realistic_deco_Queue
 123X_mcRun3_2021_realistic_Queue
 123X_mcRun3_2023_realistic_Queue
 123X_mcRun3_2024_realistic_Queue

Consult with the AlCaDB conveners if you have questions about which queue to use for your tags.

After submitting the tag request, you need to post to the AlCaDB forum about your request. Describe the payloads uploaded, the geometry changes they contain, and the pull requests that implemented those changes. List the queues and the tags with their labels. Discuss with the AlCaDB conveners if they would like you to present your request at their weekly meeting.

When the AlCaDb conveners are satisfied, they will create a new Global Tag containing the new payloads. This GT might be a test GT or an official one. Discuss with the conveners what further testing might be required at this point.

Default Geometry in GT

Extended label is associated with a default simulation geometry scenario in any given GT.

Simulation Geometry Scenarios in DB

Simulation geometry scenarios stored in a DB with the following tags, where TagXX is described in the Payloads sections.

Record	Label	Tag	Comment
GeometryFileRcd	Extended	XMLFILE_Geometry_TagXX_Extended2021_mc	Default Extended2021 geometry scenario.
GeometryFileRcd	FlatMinus05Percent	XMLFILE_Geometry_TagXX_Extended2021FlatMinus05Percent_mc	Extended2021 flat -5% tracker material scenario.
GeometryFileRcd	FlatMinus10Percent	XMLFILE_Geometry_TagXX_Extended2021FlatMinus10Percent_mc	Extended2021 flat -10% tracker material scenario.
GeometryFileRcd	FlatPlus05Percent	XMLFILE_Geometry_TagXX_Extended2021FlatPlus05Percent_mc	Extended2021 flat +5% tracker material scenario.
GeometryFileRcd	FlatPlus10Percent	XMLFILE_Geometry_TagXX_Extended2021FlatPlus10Percent_mc	Extended2021 flat +10% tracker material scenario.
GeometryFileRcd	ZeroMaterial	XMLFILE_Geometry_TagXX_Extended2021ZeroMaterial_mc	Extended2021 zero tracker material scenario.
GeometryFileRcd	Extended	XMLFILE_Geometry_TagXX_Extended_mc	Default Extended geometry scenario.
GeometryFileRcd	ExtendedGFlash	XMLFILE_Geometry_TagXX_ExtendedGFlash_mc	Extended geometry scenario with GFlash.
GeometryFileRcd	Ideal	XMLFILE_Geometry_TagXX_Ideal_mc	Ideal geometry scenario. Includes PLT.
GeometryFileRcd	ExtendedLiMin	XMLFILE_Geometry_TagXX_ExtendedLiMin_mc	Extended geometry scenario with tracker material variations.
GeometryFileRcd	ExtendedLiMax	XMLFILE_Geometry_TagXX_ExtendedLiMax_mc	Extended geometry scenario with tracker material variations.
GeometryFileRcd	ExtendedX0Min	XMLFILE_Geometry_TagXX_ExtendedX0Min_mc	Extended geometry scenario with tracker material variations.
GeometryFileRcd	ExtendedX0Max	XMLFILE_Geometry_TagXX_ExtendedX0Max_mc	Extended geometry scenario with tracker material variations.
GeometryFileRcd	ExtendedPhaseIBeamPipe	XMLFILE_Geometry_TagXX_ExtendedPhaseIBeamPipe_mc	Extended geometry scenario with Phase I beampipe.
GeometryFileRcd	ExtendedPostLS1	XMLFILE_Geometry_TagXX_ExtendedPostLS1_mc	Obsolete.
GeometryFileRcd	ExtendedPostLS2	XMLFILE_Geometry_TagXX_ExtendedPostLS2_mc	Obsolete.
GeometryFileRcd	ExtendedFlat10Percent	XMLFILE_Geometry_TagXX_ExtendedFlat10Percent_mc	Extended geometry scenario with tracker material variations.
GeometryFileRcd	ExtendedFlat20Percent	XMLFILE_Geometry_TagXX_ExtendedFlat20Percent_mc	Extended geometry scenario with tracker material variations.
GeometryFileRcd	ExtendedFlat10Services30Percent	XMLFILE_Geometry_TagXX_ExtendedFlat10Services30Percent_mc	Extended geometry scenario with tracker material variations.
GeometryFileRcd	ExtendedFlat20Services30Percent	XMLFILE_Geometry_TagXX_ExtendedFlat20Services30Percent_mc	Extended geometry scenario with tracker material variations.
GeometryFileRcd	ExtendedServices30Percent	XMLFILE_Geometry_TagXX_ExtendedServices30Percent_mc	Extended geometry scenario with tracker material variations.
GeometryFileRcd	ExtendedHFLibraryNoCastor	XMLFILE_Geometry_TagXX_ExtendedHFLibraryNoCastor_mc	Extended geometry scenario with HFLibrary and no CASTOR.
GeometryFileRcd	ExtendedZeroMaterial	XMLFILE_Geometry_TagXX_ExtendedZeroMaterial_mc	Extended geometry scenario with no material in tracker.
GeometryFileRcd	Extended2015	XMLFILE_Geometry_TagXX_Extended2015_mc	2015 Extended geometry scenario.
GeometryFileRcd	Extended2017	XMLFILE_Geometry_TagXX_Extended2017_mc	2017 Extended geometry scenario.
GeometryFileRcd	Extended2019	XMLFILE_Geometry_TagXX_Extended2019_mc	2019 Extended geometry scenario.
GeometryFileRcd	ExtendedTest2014	XMLFILE_Geometry_TagXX_ExtendedTest2014_mc	2014 Extended geometry scenario with more realistic Tracker material description. More realistic cavern. More realistic PLT. More realistic CSC.
GeometryFileRcd	Extended2015CastorSystPlus	XMLFILE_Geometry_TagXX_Extended2015CastorSystPlus_mc	2015 Extended geometry scenario with CASTOR position measured by the positioning sensors plus an upward shift within the sys uncertainty
GeometryFileRcd	Extended2015CastorSystMinus	XMLFILE_Geometry_TagXX_Extended2015CastorSystMinus_mc	2015 Extended geometry scenario with CASTOR position measured by the positioning sensors with downward shift within the sys uncertainty
GeometryFileRcd	Extended2015CastorMeasured	XMLFILE_Geometry_TagXX_Extended2015CastorMeasured_mc	2015 Extended geometry scenario with CASTOR position measured by the positioning sensors

Reconstruction Geometry in DB

Reconstruction Geometry records are as follows, where TagXX is described in the Payloads sections.

Record	Label	Tag	Comment
IdealGeometryRecord		TKRECO_Geometry_TagXX
PGeometricDetExtraRcd		TKExtra_Geometry_TagXX
PEcalBarrelRcd		EBRECO_Geometry_TagXX
PEcalEndcapRcd		EERECO_Geometry_TagXX
PEcalPreshowerRcd		EPRECO_Geometry_TagXX
PHcalRcd		HCALRECO_Geometry_TagXX
PCaloTowerRcd		CTRECO_Geometry_TagXX
PZdcRcd		ZDCRECO_Geometry_TagXX
PCastorRcd		CASTORRECO_Geometry_TagXX	Not in Run 3
CSCRecoGeometryRcd		CSCRECO_Geometry_TagXX
CSCRecoDigiParametersRcd		CSCRECODIGI_Geometry_TagXX
DTRecoGeometryRcd		DTRECO_Geometry_TagXX
RPCRecoGeometryRcd		RPCRECO_Geometry_TagXX
GEMRecoGeometryRcd		GEMRECO_Geometry_TagXX

Legacy Documentation Follows -- may not be up to date

Run the CMS.RelVal Tests

First one should follow the instructions above and make a global tag database including all the global tags used in the CMS.RelVal tests for the particular release being used in the test. Then continue with the step below in the working area that contains this database.

addpkg Configuration/PyReleaseValidation
addpkg Configuration/StandardSequences
cp Configuration/PyReleaseValidation/data/*.txt .

Edit one file. The output of diff after the edit is below:

RCS file: /cvs_server/repositories/CMSSW/CMSSW/Configuration/StandardSequences/python/FrontierConditions_CMS.GlobalTag_cfi.py,v
retrieving revision 1.9
diff -r1.9 FrontierConditions_CMS.GlobalTag_cfi.py
7c7
<     connect = cms.string('frontier://FrontierProd/CMS_COND_31X_GLOBALTAG'),
---
>     connect = cms.string('sqlite_fip:myglobaltags.db'),

Then run the test.

scram b
runTheMatrix.py >& matrix.log &

When the test is done several hours later check the log file as follows.

grep ret matrix.log

You should see only lines that look like this:

 ... ret:  0

If any tests returned nonzero values, then you will need to debug the problem. Normally the place to start is in the subdirectory that was created for the test that failed, which will contain a more detailed log for the specific test.

There are several alternative ways you can get the CMS.RelVal and other tests to run on the new payloads. Here is one relatively easy alternative. Instead of editing the file FrontierConditions_CMS.GlobalTag_cfi.py, you can modify the conditions argument to the cmsDriver command to look something like this: "--conditions MC_39Y_V3::All,sqlite_fip:./myglobaltags.db". You need to use the global tag appropriate for the test. You would have to replace all of the conditions arguments in the *.txt files used in the CMS.RelVal tests that contain the cmsDriver commands. The next section mentions some other alternatives. All the approaches are equivalent in the end, it is only a question of which approach you find more convenient as to which is best.

Alternative Ways to Access the Geometry from Database

How to access the geometry directly from CondDB is already explained here

You can cmsRun geometrytest_local.py or using the information in there in a configuration file to access this local version of the database, specifically this source (the tag names need to be edited):

process.load("CondCore.DBCommon.CondDBSetup_cfi")
process.PoolDBESSourceGeometry = cms.ESSource("PoolDBESSource",
                               process.CondDBSetup,
                               timetype = cms.string('runnumber'),
                               toGet = cms.VPSet(cms.PSet(record = cms.string('GeometryFileRcd'),tag = cms.string('XMLFILE_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('IdealGeometryRecord'),tag = cms.string('TKRECO_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('PGeometricDetExtraRcd'),tag = cms.string('TKExtra_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('PTrackerParametersRcd'),tag = cms.string('TKParameters_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('PEcalBarrelRcd'),   tag = cms.string('EBRECO_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('PEcalEndcapRcd'),   tag = cms.string('EERECO_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('PEcalPreshowerRcd'),tag = cms.string('EPRECO_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('PHcalRcd'),         tag = cms.string('HCALRECO_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('HcalParametersRcd'), tag = cms.string('HCALParameters_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('PCaloTowerRcd'),    tag = cms.string('CTRECO_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('PZdcRcd'),          tag = cms.string('ZDCRECO_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('PCastorRcd'),       tag = cms.string('CASTORRECO_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('CSCRecoGeometryRcd'),tag = cms.string('CSCRECO_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('CSCRecoDigiParametersRcd'),tag = cms.string('CSCRECODIGI_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('DTRecoGeometryRcd'),tag = cms.string('DTRECO_Geometry_TagXX')),
                                            cms.PSet(record = cms.string('RPCRecoGeometryRcd'),tag = cms.string('RPCRECO_Geometry_TagXX'))
                                            ),
                               connect = cms.string('sqlite_file:myfile.db')
                               )

If you would like to access the geometry information stored in the local file in a job in which you already use the CondDB you need to define an es_prefer in detail you have to add also this line:

process.es_prefer_geometry = cms.ESPrefer( "PoolDBESSource", "PoolDBESSourceGeometry" )

There is another alternative that can be used as well. In a standard job, one can do the following:

process.GlobalTag.globaltag = autoCond['mc']
process.source = cms.Source("EmptySource")
process.XMLFromDBSource.label=''
process.maxEvents = cms.untracked.PSet(
     input = cms.untracked.int32(1)
)
 
process.GlobalTag.toGet = cms.VPSet(cms.PSet(record = cms.string('GeometryFileRcd'),
                                             tag = cms.string('XMLFILE_Geometry_Extended_TagXX'),
                                             connect = cms.string("sqlite_file:./myfile.db")
                                             )
                                    )

Or, alternatively to use one you have uploaded to the prep account:

    process.GlobalTag.toGet = cms.VPSet(
        cms.PSet(record = cms.string("GeometryFileRcd"),
                 tag = cms.string("XMLFILE_Geometry_ExtendedX0Min_38YV0"),
                 connect = cms.string("frontier://FrontierPrep/CMS_COND_GEOMETRY")
                 )
        )

Here is a full Example to read from the local sqlite file. Note that in it, you change tag = cms.string('XMLFILE_Geometry_Extended_TagXX'), to tag = cms.string('XMLFILE_Geometry_Extended_YOUR-TAG-HERE'),.

If you are using cmsDriver then you can also use the customization fragments. Customization fragments: Example

import FWCore.ParameterSet.Config as cms
def customise(process):
    process.XMLFromDBSource.label = cms.string('ExtendedLiMax')    
    process.GlobalTag.toGet = cms.VPSet(
        cms.PSet(record = cms.string("GeometryFileRcd"),
                 tag = cms.string("XMLFILE_Geometry_ExtendedLiMax_38YV0"),
                 connect = cms.string("frontier://FrontierPrep/CMS_COND_GEOMETRY")
                 )
        )
    return (process)

Payloads In the Prep Database out of date

Tag	Description	Release	Comments
2015_74YV4	Run 2 Extended 2015 scenario Tracker parameters record.	CMSSW_7_4_X_2015-02-09-1400	Plus branch ianna:tracker-parameters-fromDB and Martin-Grunewald:TrackerTopologyEP
74YV4	Run 1 Extended scenario Tracker parameters record.	CMSSW_7_4_X_2015-02-09-1400	Plus branch ianna:tracker-parameters-fromDB and Martin-Grunewald:TrackerTopologyEP
61YV2	PostLS1 Extended geometry scenario. Integrated latest multianode description with fibre bundle description and use this in tracker variations for LiMax, LiMin, X0Max, and X0Min Extended geometry scenarios.	CMSSW_6_1_X_2012-10-11-0200	PostLS1: RE4, new beamPipe, HF PMT

Payloads In the Production Database out of date

Tag	Description	Release	Comments
110YV2	Extended 2021 geometry scenario	CMSSW_11_0_X Unknown	Created 2019-08-12
110YV1	Extended 2021 geometry scenario	CMSSW_11_0_0_pre1 + PR #26788
106YV3	Extended 2021 geometry scenario	CMSSW_10_6_0_patch2	Baseline 2021 geometry scenario
106YV2	CTPPS 2018 geometry scenario	CMSSW_10_6_X_2019-04-03-2300	Bug fix in timing detector numbering
106YV1	CTPPS 2017 geometry scenario	CMSSW_10_6_X_2019-04-03-2300	Bug fix in timing detector numbering
103YV5	Extended 2019 geometry scenario and 2019 GEM reco geometry	CMSSW_10_3_X_2018-09-30-2300 + User defined literals which do not change geometry
103YV2	Extended 2018 geometry scenario with detailed Cavern and mb4shields for neutrons	CMSSW_10_3_X_2019-02-05-2300 + PR #25879
103YV1	Extended 2018 geometry scenario	CMSSW_10_3_X_2018-09-02-2300
102YV1	CTPPS 2018 geometry scenario	CMSSW_10_2_X_2018-05-22-2300
101YV6	CTPPS 2018 geometry scenario	CMSSW_10_1_X_2018-03-19-2300 + PR#22547	Change in ideal 2018 geometry due to a rotation of the pixel detector packages in pot 56 210 far hor
101YV4	Extended 2018 geometry scenarios without Totem	CMSSW_10_1_X_2018-03-18-0000
101YV3	CTPPS 2017 geometry scenario	CMSSW_10_1_X_2018-02-19-1100	Bug fix
101YV2	CTPPS 2018 geometry scenario	CMSSW_10_1_X_2018-02-19-1100
101YV1	CTPPS 2017 geometry scenario	CMSSW_10_1_X_2018-02-04-2300
10YV4	Extended 2018 with GEM geometry bug fix	CMSSW_10_1_0 + PR#22730	https://twiki.cern.ch/twiki/pub/CMSPublic/SWGuideDataBaseGeometry/GEMDPG12APR.pdf GEM geometry unit bug fix: duplicated division by cm
10YV4	Extended 2018 Zero Material in Tracker scenario	CMSSW_10_1_X_2018-02-19-1100	Tracker materials taken from 2017 Zero Material scenario
10YV4	Extended 2018 with Hcal collapsed depths and GEM detailed info	CMSSW_10_0_X_2018-01-15-2300	https://hypernews.cern.ch/HyperNews/CMS/get/calibrations/3457.html
10YV3	Extended 2018 with Hcal Plan 36 and GEM detailed info	CMSSW_10_0_X_2018-01-15-2300
92YV6	Extended 2018 with GEM slice geometry bug fix	CMSSW_9_2_X_2017-06-20-1100
92YV5	Extended 2017 Plan1 with GEM slice geometry bug fix	CMSSW_9_2_X_2017-06-20-1100
92YV4	Extended 2018 with BPix geometry material tuning	CMSSW_9_2_X_2017-05-17-2300 + PR#18824
92YV3	Extended 2017 Plan 1 with BPix geometry material tuning	CMSSW_9_2_X_2017-05-17-2300 + PR#18824
92YV2	Extended 2018 with BPix geometry fix	CMSSW_9_2_X_2017-05-09-2300 + PR#18651
92YV1	Extended 2017 Plan 1 with BPix geometry fix	CMSSW_9_2_X_2017-05-09-2300 + PR#18651
91YV5	Extended 2023 D11 scenario with final Tracker for TDR	CMSSW_9_1_X_2017-04-10-2300 + PR#18253
91YV4	Extended 2017 Plan 1 with Zero material in Tracker	CMSSW_9_1_X_2017-03-20-2300 + https://github.com/cms-sw/cmssw/pull/18008 + https://github.com/cms-sw/cmssw/pull/18024
91YV3	Extended 2018 scenario with HCal TP bugfix	CMSSW_9_1_X_2017-03-15-2300 + matz-e/hcal-tp-2018-fix-geometry
91YV2	Extended 2018 scenario	CMSSW_9_1_X_2017-03-07-1100 plus the following branches: ianna:beampipe-2017-v2, ianna:extended-2017-plan1-scenario-scripts, ianna:xml-file-restructuring, ianna:xml-file-restructuring-v2	synchronises updates included in 91YV1 tags for Extended 2017 Plan 1 scenario: updated beampipe and overlap fix in GE11.
91YV1	Extended 2017 Plan 1 scenario	CMSSW_9_1_X_2017-03-07-1100 plus the following branches: ianna:beampipe-2017-v2, ianna:extended-2017-plan1-scenario-scripts, ianna:xml-file-restructuring, ianna:xml-file-restructuring-v2	Al 2219 material in a beam pipe middle section, GE11 overlap bug fix and updated shielding (as actually built), xml file restructuring
90YV12	Reserved for data tags built from 90YV11
90YV11	Extended 2017 Plan 1 scenario	CMSSW_9_0_X_2017-02-22-2300	HCal and CaloTower reco geometry tags == 90YV10
90YV10	Extended 2017 Plan 1 scenario	CMSSW_9_0_X_2017-02-20-2300 + PR#17581
90YV9	Extended 2017 scenario		Overlap fix TOB with TIB rail bottom
90YV8
90YV7	Extended 2018 scenario sync with 90YV6
90YV6	Extended 2017 scenario with reactivated big pixels for the Phase 1 pixel topology, tracker overlap bug fixes, replace one section Polycone in Pixel Fwd with Tubs	CMSSW_9_0_X_2017-02-02-2300 + PR#17384 + PR#17383 + PR#17387
90YV5	Extended 2018 scenario with HCal 2017 numbering	CMSSW_9_0_X_2017-01-23-2300 + PR#17291
90YV4	Extended 2017 scenario with tuned reco material	CMSSW_9_0_X_2017-01-23-2300 + 90YV3 PRs (see beneath) + PR#17280 + PR#17261	Merged branches: ianna:tib-rail-bottom-overlap-fix, rovere/recoMaterialTuning
90YV3	Extended 2017 scenario with HCal 2017a numbering, GEM slice, overlap fixes and Pixel material update	CMSSW_9_0_X_2017-01-23-2300 + PR#17198 + PR#17099 + PR#17192 + PR#17156 + PR#17199 + PR#17130 + PR#17131 + PR#17115 + PR#17245	Merged branches: bsunanda/Run2-hcx97, ianna/fpix-overlap-fix-v2, ianna/gem-in-2017-payload-scripts, ianna/tob-connect56-overlap-fix, kpedro88/Phase1-HE14, schneiml/pixel-matbudget-changes-st See slides here
90YV2	Extended 2017 scenario with HCal 2017a numbering (and no GEM slice)	CMSSW_9_0_X_2017-01-17-2300 + PR#17198
90YV1	Extended 2017 scenario with GEM slice	CMSSW_9_0_X + PR#17130
81YV023	Extended 2023 scenario with TDR baseline GEM, ME0, Tilted tracker	CMSSW_8_1_0 + PR#17036	Hcal and RPC updated to 2023, no HGCal yet.
81YV15	Extended 2017 scenario	CMSSW_8_1_X_2016-11-16-2300	Fix all remaining overlaps in Pixel support structure. Subtraction with Union solid replacement in ES support structure. Note, there are no changes in sensitive volumes and Pixel support structure material density has been corrected to compensate for the (very minimal) shape changes.
81YV14	Extended 2017 scenario	CMSSW_8_1_X_2016-11-01-2300 plus PR#16416	Extended2017new becomes Extended2017 scenario. BeamPipe extrusion fix. More realistic Pixel with updated material. Updated Tracker reco material.
81YV13	Extended 2017new scenario with Hcal geometry changes for 2017	CMSSW_8_1_X 26-Oct-2016	Fixes a problem with CutTubs observed in GeometryFileRcd (81YV11)
81YV11	Extended 2017new scenario with Hcal geometry changes for 2017	CMSSW_8_1_0_pre13	Fixes a problem with mixing vector content in an Hcal reco schema (relevant code changes are already in pre13) and aligns sim geometry and Tracker reco geometry to a current one built from xml
81YV9	Extended 2017dev scenario with Hcal geometry changes for 2017	CMSSW_8_1_X_2016-10-18-1100
81YV8	Extended 2017dev scenario with Hcal geometry changes for 2017 - DO NOT USE (stored parameters order has changed and does not match stored dense index order)	CMSSW_8_1_X_2016-09-19-2300 + PR#15918
81YV7	Extended 2017 scenario with Hcal geometry changes for 2016a	CMSSW_8_1_X_2016-09-19-2300
81YV6	Extended 2017 scenario with new Tracker reco materials.	CMSSW_8_1_X_2016-07-03-2300 + PR#15110
81YV5	Extended 2017 scenario with Hcal geometry changes for 2016a and with new BPIX module cable materials, new FPIX portcard material and dimensions. Changes to BPIX Phase 1 geometry to match latest design.	CMSSW_8_1_X_2016-06-02-1100 + PR#14726
81YV4	Extended 2017 scenario with Hcal geometry changes for 2016a and with new BPIX module cable materials, new FPIX portcard material and dimensions	CMSSW_8_1_X_2016-06-02-1100
81YV3	Extended 2017 scenario with Hcal geometry changes for 2016a	CMSSW_8_1_X_2016-05-31-2300	Requested for upgrade2017 GT
81YV2	Extended 2015 scenario with Tracker material variations	CMSSW_8_1_X IB + PR#14010	Tags with labels (FlatMinus05Percent, FlatMinus10Percent, FlatPlus05Percent, FlatPlus10Percent) are included in GT queue 80X_mcRun2_asymptotic_2016_v3_GeomVars
2016_81YV1	Hcal geometry changes for 2016	CMSSW_8_1_X IB + PR#13491	2015 PROD geometry + Hcal parameters change for trigger primitives
2017_80YV2	Hcal geometry changes for 2017	CMSSW_8_0_0_pre6 + PR#13139	See summary at https://indico.cern.ch/event/492087/contribution/4/note/
2016_80YV2	Hcal geometry changes for 2016	CMSSW_8_0_0_pre6 + PR#13139	See summary at https://indico.cern.ch/event/492087/contribution/4/note/
80YV1	Alternative geometry scenarios with shifted castor.	CMSSW_8_0_X plus PR # 11928	Based on Extended 2015 and 2015 dev geometry scenarios.
Run1_76YV6	CaloTower reco geometry with dense indexing (reflects changes of Hcal reco geometry)	CMSSW_7_6_X_2015-10-02-2300	Plus kpedro88:migrate-CT3
Run1_76YV5	CaloTower reco geometry (reflects changes of Hcal reco geometry) - DO NOT USE	CMSSW_7_6_X_2015-10-02-2300	Plus kpedro88:migrate-CT3
Run1_76YV4	Sim geometry scenarios including Hcal parameters, excluding Ecal cables - DO NOT USE XMLFILE_Geometry_Run1_76YV4_Extended_mc, XMLFILE_Geometry_Run1_76YV4_ExtendedZeroMaterial_mc, XMLFILE_Geometry_Run1_76YV4_Ideal_mc
Run2_76YV4
Run1_76YV3	Hcal Reco geometry (small changes - more precise)		HCALRECO_Geometry_Run1_76YV3 is identical to HCALRECO_Geometry_Run1_76YV4
Run2_76YV3
Run1_76YV2	Sim geometry scenarios including Hcal parameters
Run2_76YV2
Run1_76YV1	Hcal parameters for run 1 and run 2
2017_75YV1	Extended 2017 scenario	CMSSW_7_5_1	2017 Tracker parameters, sim and reco geometry
Run1_75YV4	HCAL Spec pars	CMSSW_7_5_X	Adding extra constants and regexps for selection - no changes in geometry.
Run2_75YV4
Run1_75YV2	HCAL parameters record	CMSSW_7_5_X	Run 1 and Run 2 parameters are identical
Run1_75YV1	Run 1 Tracker parameters record	CMSSW_7_5_X_2015-04-05-2300	Plus ianna:use-tracker-parameters-fromDB-75x
Run2_75YV1	Run 2 Tracker parameters record	CMSSW_7_5_X_2015-04-05-2300	Plus ianna:use-tracker-parameters-fromDB-75x
Run3_75YV1	Run 3 Tracker parameters record	CMSSW_7_5_X_2015-04-05-2300	Plus ianna:use-tracker-parameters-fromDB-75x
Run1_71YV6	Run 1 Extended, Ideal and ExtendedZeroMaterial geometries with new default material budget as in ExtendedTest2014	CMSSW_7_1_X_2015-02-22-0200 ianna:default-material-budget-for-run1
74YV3	Tracker geometry NOT changed: but introducing DetId Shifts in GeometricDet builder	CMSSW_7_4_X_2015-01-18-0200	Transient version is already using them, but it should not affect current geometry.
74YV2	2015 Development scenarios	CMSSW_7_4_X_2014-12 IB
74YV1	Sync Ideal2015 with Extended2015 scenario	CMSSW_7_4_X_2014-12-16-0200 IB	Extended2015 scenario is identical to 2015_71YV5
2015_72YV6	Extended Run 2 geometry alternative scenarios with shifted castor	CMSSW_7_2 plus PR #11928
2015_72YV5	Extended Run 2 geometry with RPC station 4 rotation fix. Sync tracker material changes to Run1_72YV3	CMSSW_7_2_X IB plus PR #5319	Sep 18 2014 Note: RPC sim and reco geometry changes.
2015_72YV4	Extended Run 2 geometry with more realistic material description. Sync tracker material changes to Run1_72YV3	CMSSW_7_2_X IB	Sep 10 2014
Run1_72YV3	Extended Run 1 geometry with more realistic material description. Note: ExtendedTest2014 is not backward-compatible. It requires new plugin for BCM1F sensitive detector.	CMSSW_7_2_X IB	Sep 4 2014
2015_72YV2	Extended2015 geometry for Run 2 with ZeroMaterial	CMSSW_7_2_X IB	Aug 29 2014
2015_71YV5	Extended Run 2 geometry with RPC station 4 rotation fix. Sync tracker material changes to Run1_71YV4	CMSSW_7_1_X IB (?)	Jul 28 2014 Note: RPC sim and reco geometry changes. (-- SalvatoreDiGuida - 21 Oct 2014)
2015_71YV4_Extended2015	Extended geometry from Run 2	CMSSW_7_1_X IB	Fix some Geant4 warnings raised by the 2015_71YV3 tags (-- SalvatoreDiGuida - 21 Oct 2014)
2015_71YV3	More realistic Tracker material, PLT, BCM, CSC, cavern. Pilot blades material. New Castor description.	CMSSW_7_1_X IB	DetIds unchanged for Castor. Extended label is assigned to Extended2015 scenario.
71YV1	Tracker geometry changed: more realistic material description. More realistic cavern. More realistic PLT. More realistic CSC.	CMSSW_7_1_X IB	Only one tag so far: ExtendedTest2014
62YV6	Tracker geometry changed: a bug fix in TEC XML description - moving the Ring 7 modules to their correct position.	Geometry/TrackerCommonData V01-10-00
62YV5	Upgrade HCAL geometry with HB depth 7 and HE depth 7.
62YV4	New PCaloGeometry schema in ProdDB CMS_COND_GEOMETRY_000 account		This introduces storage of a dense index for HCAL upgrade geometry which requires PCaloGeometry schema change in the database, and therefore a new Tag for this Condition.
61YV2	PostLS1 Extended geometry scenario. Integrated latest multianode description with fibre bundle description and use this in tracker variations for LiMax, LiMin, X0Max, and X0Min Extended geometry scenarios.	CMSSW_6_1_X_2012-10-11-0200	PostLS1: RE4, new beamPipe, HF PMT
50YV4	Improved memory model for PGeometricDet::Item and TKRECO geometry		PGeometricDet::Item members re-arranged to improve padding.
		CondFormats/GeometryObjects V00-09-01
50YV3	A new beampipe and correct HO geometry		More realistic beampipe.
		CMSSW_5_0_0_pre2 and
		V01-04-13 Geometry/HcalCommonData
		V01-09-02 Geometry/TrackerCommonData
		V01-07-09 Geometry/HcalTestBeamData
		V05-04-07 Geometry/TrackerGeometryBuilder
50YV1	Repaired-z-geometry for the endcap and preshower		The z shifts (more than one) are in a combination of the xml files and associated C++ code DDEcalEndcapAlgo.cc/.h - all in Geometry/EcalCommonData.
44YV2	Improved memory model for CMS calo geometry		Performance improvements.
		V05-03-11 Geometry/EcalCommonData
		V00-06-04 Geometry/EcalAlgo
		V05-08-01 RecoEcal/EgammaCoreTools
		V03-13-06 Geometry/CaloGeometry
		V01-05-03 Geometry/ForwardGeometry
		V00-09-00 CondFormats/GeometryObjects
		V00-04-01 CondTools/Geometry
		V01-12-00 DataFormats/HcalDetId
		V03-11-03 Geometry/CaloEventSetup
		V00-09-03 Geometry/EcalTestBeam
		V01-07-04 Geometry/HcalTowerAlgo
		V00-04-00 SimDataFormats/EcalTestBeam
		V01-05-04 Geometry/ForwardGeometry
42YV1	Backporting improved memory model for CMS calo geometry		Performance improvements.
		V00-09-00 CondFormats/GeometryObjects
		V00-04-01 CondTools/Geometry
		V01-12-00 DataFormats/HcalDetId
		V03-11-03 Geometry/CaloEventSetup
		V03-13-06 Geometry/CaloGeometry
		V00-06-04 Geometry/EcalAlgo
		V00-09-03 Geometry/EcalTestBeam
		V01-05-04 Geometry/ForwardGeometry
		V01-07-04 Geometry/HcalTowerAlgo
		V05-07-00-01 RecoEcal/EgammaCoreTools
		V00-04-00 SimDataFormats/EcalTestBeam
42YV1	TOTEM added	IB CMSSW_4_2_X_2011-02-12-0200
311YV1	TOTEM added	CMSSW_3_11_1_patch1 plus the following tags:
		Geometry/CMSCommonData V01-07-08
		SimG4CMS/Calo V02-07-03
		SimG4Core/Application V05-15-19

Review Status

Reviewer/Editor and Date (copy from screen)	Comments
MichaelCase - 27 Jan 2006	page author
JennyWilliams - 31 Jan 2007	moved text here from SWGuideDetectorDescription and edited for SWGuide
MichaelCase - 12-Sep-2010	Brought up to date as of 3.9.X IB's

Last reviewed by: Reviewer