[Octave-bug-tracker] [bug #60783] hist: better documentation for third "norm" parameter

[Kai Torben Ohlhus]

URL:
  <https://savannah.gnu.org/bugs/?60783>

                 Summary: hist: better documentation for third "norm"
parameter
                 Project: GNU Octave
            Submitted by: siko1056
            Submitted on: Wed 16 Jun 2021 10:32:10 AM JST
                Category: Octave Function
                Severity: 2 - Minor
                Priority: 5 - Normal
              Item Group: Documentation
                  Status: In Progress
             Assigned to: siko1056
         Originator Name: 
        Originator Email: 
             Open/Closed: Open
                 Release: 6.2.0
         Discussion Lock: Any
        Operating System: Any

    _______________________________________________________

Details:

In addition to bug #42394, it is not really specified what the third norm
parameter should be.

This recently led to confusion
https://octave.discourse.group/t/parameter-norm-for-function-hist/1262/2 how
to use it properly.

In essence: "norm" can either be a scalar, or a (row) vector with as many
elements as bars are given


>> [nn, xx] = hist(rand(10,2),0:5); nn', xx'
ans =

   5   5   0   0   0   0
   4   6   0   0   0   0

ans =

   0   1   2   3   4   5

>> [nn, xx] = hist(rand(10,2),0:5, 1); nn', xx'
ans =

   0.6000   0.4000        0        0        0        0
   0.5000   0.5000        0        0        0        0

ans =

   0   1   2   3   4   5

>> [nn, xx] = hist(rand(10,2),0:5, [1 1]); nn', xx'
ans =

   0.6000   0.4000        0        0        0        0
   0.5000   0.5000        0        0        0        0

ans =

   0   1   2   3   4   5

>> [nn, xx] = hist(rand(10,2),0:5, [1 1]'); nn', xx'
error: .*=: nonconformant arguments (op1 is 6x2, op2 is 2x2)
error: called from
    hist at line 230 column 10
>> [nn, xx] = hist(rand(10,2),0:5, [1 1 1]); nn', xx'
error: quotient: nonconformant arguments (op1 is 1x3, op2 is 1x2)
error: called from
    hist at line 230 column 10





    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?60783>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/