matrix_props: Check if stochastic or doubly stochastic

[purva-thakre]

Description

Fixes #559
Fixes #560

Changes

Notable changes that this PR has either accomplished or will accomplish. Feel free to add more lines to the itemized list
below.

• Instead of adding an is_stochastic function, this PR adds an is_right_stochastic and an is_left_stochastic function as the Wikipedia definitions make sure to distinguish the two. For 1 def, the rows should sum up to 1 while in the other, the columns should sum up to 1.
• Also adds an is_doubly_stochastic function for the cases when a matrix is both right and left stochastic.

Checklist

Before marking your PR ready for review, make sure you checked the following locally. If this is your first PR, you might be notified of some workflow failures after a maintainer has approved the workflow jobs to be run on your PR.

Additional information is available in the documentation.

• Use ruff for errors related to code style and formatting.
• Verify all previous and newly added unit tests pass in pytest.
• Check the documentation build does not lead to any failures. Sphinx build can be checked locally for any failures related to your PR
• Use linkcheck to check for broken links in the documentation
• Use doctest to verify the examples in the function docstrings work as expected.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 97.7%. Comparing base (de9a087) to head (2eb2fd7).
Report is 18 commits behind head on master.

Additional details and impacted files

@@          Coverage Diff           @@
##           master    #723   +/-   ##
======================================
  Coverage    97.7%   97.7%           
======================================
  Files         166     167    +1     
  Lines        3250    3252    +2     
  Branches      795     795           
======================================
+ Hits         3177    3179    +2     
  Misses         48      48           
  Partials       25      25           

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

[purva-thakre]

@vprusso I am confused as to why the coverage report shows a line uncovered by unit tests in all 3 functions.

[vprusso]

Looks like there are still some uncovered cases from the coverage report here:
https://github.com/vprusso/toqito/pull/723/checks?check_run_id=28300233677

[purva-thakre]

Looks like there are still some uncovered cases from the coverage report here: https://github.com/vprusso/toqito/pull/723/checks?check_run_id=28300233677

@vprusso Yes, I brought this up in a previous comment. The lines should not show up as uncovered but they do.

#723 (comment)

[vprusso]

LGTM, nice work, @purva-thakre !