From 9e6c29a35ab34a1c88dbac23af2e4b0a1f6ee6bd Mon Sep 17 00:00:00 2001 From: Jaidev Deshpande Date: Thu, 2 Jul 2015 09:45:36 +0530 Subject: [PATCH] DOC: Better explain the behaviour of na_values --- doc/source/io.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/doc/source/io.rst b/doc/source/io.rst index 9852822c556dc..185deb4b9cae8 100644 --- a/doc/source/io.rst +++ b/doc/source/io.rst @@ -115,7 +115,7 @@ They can take a number of arguments: as the index. - ``names``: List of column names to use as column names. To replace header existing in file, explicitly pass ``header=0``. - - ``na_values``: optional list of strings to recognize as NaN (missing + - ``na_values``: optional string or list of strings to recognize as NaN (missing values), either in addition to or in lieu of the default set. - ``true_values``: list of strings to recognize as ``True`` - ``false_values``: list of strings to recognize as ``False`` @@ -723,7 +723,8 @@ NA Values ~~~~~~~~~ To control which values are parsed as missing values (which are signified by ``NaN``), specifiy a -list of strings in ``na_values``. If you specify a number (a ``float``, like ``5.0`` or an ``integer`` like ``5``), +string in ``na_values``. If you specify a list of strings, then all values in +it are considered to be missing values. If you specify a number (a ``float``, like ``5.0`` or an ``integer`` like ``5``), the corresponding equivalent values will also imply a missing value (in this case effectively ``[5.0,5]`` are recognized as ``NaN``.