Document preview_namelist usage

ESMCI / cime

Common Infrastructure for Modeling the Earth

http://esmci.github.io/cime

Other

161 stars 206 forks source link

Document preview_namelist usage #1277

Open rljacob opened 7 years ago

rljacob commented 7 years ago

The logic for when preview_namelist is called and how it keeps namelists in sync should be documented. Its a script available to user's so we should tell them when they might need to run it if they don't want CIME to do it all for them.

rljacob commented 7 years ago

For a regular create_newcase, I think this is the sequence and reasons:

Called during case.build before the actual build:
- because some builds need namelist info. First time all namelists are built.
Called in case.submit
- because users may have changed an xml file after building.
Called in case.run
- because users may have changed an xml file while the job is in the queue before it runs.

jedwards4b commented 7 years ago

You mean preview_namelists

rljacob commented 7 years ago

Thanks. Fixed it.

rljacob commented 7 years ago

According to @jgfouca in https://github.com/ESMCI/cime/pull/1203#issuecomment-284095407, this is the sequence for create_test:

Called post-SETUP by create_test (if compare or generate baselines)
Called in build.py for sharedlib build
Called in case.submit
Called once per invocation of case_run.run_model

github-actions[bot] commented 1 year ago

This issue is stale because it has been open 90 days with no activity. Remove stale label or comment or this will be closed in 5 days.

github-actions[bot] commented 10 months ago

This issue is stale because it has been open 90 days with no activity. Remove stale label or comment or this will be closed in 5 days.

rljacob commented 10 months ago

still need this.