Possible Notation / Conceptual Inaccuracy in `BaseValue` Description – Chapter 8.1 (Exercise 8.1) page 251

Open Beginner friendly
#228 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
1-3 hours
Newbie friendliness
72/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Domain
documentation

Research direction

Find the Chapter 8.1 text following Exercise 8.1 on page 251 and review the description of the BaseValue name-value pair for bar and barh. Check that the wording distinguishes the baseline value from the axes' intersection and explains which axis the baseline applies to for each function. Done when the text accurately describes both behaviors.

Written by the indexing model from the issue text.

Description

Suggestion for the next edition

Dear Professors,

While reviewing the examples and exercises in Chapter 8.1, I focused on the explanation of the 'BaseValue' name-value pair following Exercise 8.1 on page 251.

Image

The text currently states:

"The 'BaseValue' name-value pair in bar and barh specifies where the $x$-axis intersects the $y$-axis."

Looking at this definition, I wondered whether this formulation might contain a small technical/notational inaccuracy regarding how MATLAB handles coordinate axes and baseline positioning:

  1. Axis Intersection vs. Baseline Position: The 'BaseValue' property does not shift the axes or alter the intersection of the Cartesian coordinate system ($x$-axis and $y$-axis). In MATLAB graphics, axis placement and intersections are controlled via Axes properties (such as XAxisLocation and YAxisLocation).
  2. Behavioral Difference in bar vs. barh:
    • For bar (vertical bars), BaseValue sets the horizontal baseline value on the $y$-axis from which the bars originate.
    • For barh (horizontal bars), BaseValue sets the vertical baseline value on the $x$-axis from which the bars originate.

I was wondering if a clearer formulation might be:

"The 'BaseValue' name-value pair in bar and barh specifies the baseline value from which the bars originate (along the $y$-axis for bar and along the $x$-axis for barh)."

or if there was a specific subtlety in the text's phrasing that I haven't fully grasped yet.

I hope this observation is helpful, and thank you as always for your time and guidance!

Dominant language
MATLAB
Stars
30
Forks
1
PR merge metrics
No merged PRs in 30d

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from UniprJRC/DSwithMATLAB

All issues in UniprJRC/DSwithMATLAB

Similar issues

More MATLAB issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.