[UPDATE] lib, README.
[UPDATE] README.
[UPDATE] README. Examples.
[UPDATE] array length argument.
[TESTS] additional tests for input arguments.
[TODO]
[TODO]
[UPDATE] README.
[UPDATE] fcn documentation.
[TODO]
[UPDATE] name fcns.
[TODO]
[TESTS] array length.