Feature/juvenile dispersal - Adding juvenile dispersal to the Animal Module

[TaranRallings]

Description

Following Madingley, this builds on previous starvation-induced dispersal to add a dispersal check immediately after a cohort is born. When migrate_community is called during the normal flow of model execution there is a secondary check to see if the cohort is newly created. If the cohort is new, it creates a probability of dispersal based on allometric movement speed and grid size.

Currently, this only works for 'rook move' dispersal. The logic can be expanded for diagonal movement and multi-grid occupancy but we can leave that for a little later.

Fixes # (issue)

Type of change

• New feature (non-breaking change which adds functionality)
• Optimization (back-end change that speeds up the code)
• Bug fix (non-breaking change which fixes an issue)

Key checklist

• Make sure you've run the pre-commit checks: $ pre-commit run -a
• All tests pass: $ poetry run pytest

Further checks

• Code is commented, particularly in hard-to-understand areas
• Tests added that prove fix is effective or that feature works

[dalonsoa]

I've a couple of comments related to the naming or interpretation of the probability. But otherwise looks good.

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 94.62%. Comparing base (88a6de3) to head (af0f340).

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #419      +/-   ##
===========================================
+ Coverage    94.59%   94.62%   +0.02%     
===========================================
  Files           69       69              
  Lines         3648     3666      +18     
===========================================
+ Hits          3451     3469      +18     
  Misses         197      197              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[dalonsoa]

A couple of suggestions for the probability part, but looks good otherwise.