Skip to content

Conversation

@fvitt
Copy link
Collaborator

@fvitt fvitt commented Jan 13, 2026

This provides the option to use the TUV-x library to compute photo-chemical rates in-line as an alternative to the traditional table look up method.

Closes #757

fvitt added 2 commits January 7, 2026 10:28
	modified:   .gitmodules
	modified:   cime_config/buildlib
	modified:   libraries/tuv-x (new commits)
Copy link
Member

@jimmielin jimmielin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @fvitt - I had some minor suggested changes that are hopefully straightforward.

call mee_ion_final()
call rate_diags_final()
call species_sums_final()
call tuvx_finalize()
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could maybe wrap this within if (tuvx_active) to be consistent with the other calls

!-----------------------------------------------------------------
! ... get calculated photolysis rates from TUV-x
!-----------------------------------------------------------------
call tuvx_get_photo_rates( state, pbuf, ncol, lchnk, zmid, zint, &
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks like the only place tuvx_get_photo_rates uses state is to get state%ncol in line ~679, but ncol is already passed in here. Maybe state does not have to be passed in to call tuvx_get_photo_rates

Comment on lines +261 to +271
subroutine gas_phase_chemdr(lchnk, ncol, imozart, q, &
phis, zm, zi, calday, &
tfld, pmid, pdel, pint, rpdel, rpdeldry, &
cldw, troplev, troplevchem, &
ncldwtr, ufld, vfld, &
delt, ps, &
fsds, ts, asdir, ocnfrac, icefrac, &
precc, precl, snowhland, ghg_chem, latmapback, &
drydepflx, wetdepflx, cflx, fire_sflx, fire_ztop, nhx_nitrogen_flx, noy_nitrogen_flx, &
use_hemco, qtend, pbuf)
drydepflx, wetdepflx, cflx, fire_sflx, fire_ztop, &
nhx_nitrogen_flx, noy_nitrogen_flx, &
use_hemco, qtend, pbuf, state)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These changes appear to be unnecessary as state was already previously passed in as the first argument, and was moved to the last one for some reason.

use mo_chm_diags, only : chm_diags, het_diags
use perf_mod, only : t_startf, t_stopf
use gas_wetdep_opts, only : gas_wetdep_method
use physics_types, only : physics_state
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This line is a duplicate of line 318 and does not need to be added again

Comment on lines +1276 to +1283
call gas_phase_chemdr(lchnk, ncol, imozart, state%q, &
state%phis, state%zm, state%zi, calday, &
state%t, state%pmid, state%pdel, state%pint, state%rpdel, state%rpdeldry, &
cldw, tropLev, tropLevChem, ncldwtr, state%u, state%v, chem_dt, state%ps, &
fsds, cam_in%ts, cam_in%asdir, cam_in%ocnfrac, cam_in%icefrac, &
cam_out%precc, cam_out%precl, cam_in%snowhland, ghg_chem, state%latmapback, &
drydepflx, wetdepflx, cam_in%cflx, cam_in%fireflx, cam_in%fireztop, &
nhx_nitrogen_flx, noy_nitrogen_flx, use_hemco, ptend%q, pbuf )
nhx_nitrogen_flx, noy_nitrogen_flx, use_hemco, ptend%q, pbuf, state )
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These changes appear to be unnecessary as state was already previously passed in as the first argument, and was moved to the last one for some reason.

Comment on lines +52 to +53
integer, parameter :: PROFILE_INDEX_SO2 = 7 ! Sulfur dioxide profile index
integer, parameter :: PROFILE_INDEX_NO2 = 8 ! Nitrogen dioxide profile index
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These appear to be non-public and unused, can I ask if these are intended to be not implemented?

Comment on lines +60 to +63
! Definition of the MS93 wavelength grid TODO add description of this
integer, parameter :: NUM_BINS_MS93 = 4
real(kind=r8), parameter :: WAVELENGTH_EDGES_MS93(NUM_BINS_MS93+1) = &
(/ 181.6_r8, 183.1_r8, 184.6_r8, 190.2_r8, 192.5_r8 /)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missed TODO here about the description here

Comment on lines +451 to +454
deallocate( cam_grids )
deallocate( cam_profiles )
deallocate( cam_radiators )
deallocate( wavelength )
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since wavelength => cam_grids%get_grid(...) I would suggest switching the deallocate order for safety

Suggested change
deallocate( cam_grids )
deallocate( cam_profiles )
deallocate( cam_radiators )
deallocate( wavelength )
deallocate( wavelength )
deallocate( cam_grids )
deallocate( cam_profiles )
deallocate( cam_radiators )


host_profile => profiles%get_profile( "temperature", "K" )
this%profiles_( PROFILE_INDEX_TEMPERATURE ) = this%core_%get_updater( host_profile, found )
call assert( 418735162, found )
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here and throughout the file, there are many calls to musica_assert::assert with seemingly random numbers for unique error codes. It seems to be consistent with what's done elsewhere in MUSICA, but I would request to at least have a comment somewhere that these numbers are just unique error codes and don't have any particular meaning other than being unique, and this is how the MUSICA library handles errors. Thanks!

! || ||
! ||
! ----------------- i_int = pver
! ================= i_imd = pver ------------------ i_int = 2
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

typo here:

Suggested change
! ================= i_imd = pver ------------------ i_int = 2
! ================= i_mid = pver ------------------ i_int = 2

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

2 participants