Update POP docs regarding SourceMods and restarts in GDEX

[mjs2369]

Description:

Update POP docs to include discussion of SourceMods and where to get them and the availability of the initial restarts in the GDEX

Fixes issue

Fixes #476

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update

Documentation changes needed?

• My change requires a change to the documentation.
  • I have updated the documentation accordingly.

Tests

Built docs

Checklist for merging

• Updated changelog entry
• Documentation updated
• Update conf.py

Checklist for release

• Merge into main
• Create release from the main branch with appropriate tag
• Delete feature-branch

Testing Datasets

• Dataset needed for testing available upon request
• Dataset download instructions included
• No dataset needed

[mjs2369]

Do we think the documentation about LANL POP is still needed?

DART/models/POP/readme.rst

Lines 26 to 38 in e218864

	LANL POP
	~~~~~~~~
	In years subsequent to the initial development of the DART interface, the
	Computer, Computational, and Statistical Sciences Division at LANL transitioned
	from using POP as their primary ocean model to using the Model for Prediction
	Across Scales-Ocean (MPAS-Ocean). Thus it became difficult for staff in the
	Data Assimilation Research Section (DAReS) at NSF NCAR to maintain access to the
	`LANL POP <https://climatemodeling.science.energy.gov/projects/climate-ocean-and-sea-ice-modeling-cosim>`_
	source code. As a result, LANL POP has been tested using DART's Lanai framework
	but has not been tested using DART's Manhattan framework. If you intend to use
	LANL POP with DART Manhattan, contact DAReS staff for assistance by emailing
	[email protected].

[hkershaw-brown]

Nice work on getting the data on GDEX (Ben & Marlee)

I put a couple of definite changes in (keep Alicia's reference, remove the note about 'variable use_SourceMods').

Once Ben is happy with this, seems good to go.

[mjs2369]

Do we need DART/models/POP/README as well as the main readme.rst? There is some info about the broken test, test_dipole_interp, but mostly it is just development notes; see the comment below

DART/models/POP/README

Lines 72 to 75 in e218864

	#----------------------------------------------------------------------
	# Everything below here is just notes from the development process.
	# It is highly unlikely it will mean anything to anyone but Tim H.
	#----------------------------------------------------------------------

[hkershaw-brown]

Do we need DART/models/POP/README as well as the main readme.rst? There is some info about the broken test, test_dipole_interp, but mostly it is just development notes; see the comment below

DART/models/POP/README

Lines 72 to 75 in e218864

	#----------------------------------------------------------------------
	# Everything below here is just notes from the development process.
	# It is highly unlikely it will mean anything to anyone but Tim H.
	#----------------------------------------------------------------------

Dunno, but it seems out of scope for adding the GDEX info to the docs.

[johnsonbk]

I think it's still in the scope of this pull request to git rm DART/models/POP/shell_scripts/cesm2_1/copy_POP_JRA_restarts.py since that script is now obsolete.

[mjs2369]

I think it's still in the scope of this pull request to git rm DART/models/POP/shell_scripts/cesm2_1/copy_POP_JRA_restarts.py since that script is now obsolete.

Good idea @johnsonbk, I'll do that now

[hkershaw-brown]

looks good Marlee, great to have the data on GDEX.

[johnsonbk]

Hooray!