pandas 1.4.2

ParametersReturns
read(self, nrows: 'int | None' = None, convert_dates: 'bool | None' = None, convert_categoricals: 'bool | None' = None, index_col: 'str | None' = None, convert_missing: 'bool | None' = None, preserve_dtypes: 'bool | None' = None, columns: 'Sequence[str] | None' = None, order_categoricals: 'bool | None' = None) -> 'DataFrame'

Parameters

nrows : int

Number of lines to read from data file, if None read whole file.

convert_dates : bool, default True

Convert date variables to DataFrame time values.

convert_categoricals : bool, default True

Read value labels and convert columns to Categorical/Factor variables.

index_col : str, optional

Column to set as index.

convert_missing : bool, default False

Flag indicating whether to convert missing values to their Stata representations. If False, missing values are replaced with nan. If True, columns containing missing values are returned with object data types and missing values are represented by StataMissingValue objects.

preserve_dtypes : bool, default True

Preserve Stata datatypes. If False, numeric data are upcast to pandas default types for foreign data (float64 or int64).

columns : list or None

Columns to retain. Columns will be returned in the given order. None returns all columns.

order_categoricals : bool, default True

Flag indicating whether converted categorical data are ordered.

Returns

DataFrame

Reads observations from Stata file, converting them into a dataframe

Examples

See :

Local connectivity graph

Hover to see nodes names; edges to Self not shown, Caped at 50 nodes.

Using a canvas is more power efficient and can get hundred of nodes ; but does not allow hyperlinks; , arrows or text (beyond on hover)

SVG is more flexible but power hungry; and does not scale well to 50 + nodes.

All aboves nodes referred to, (or are referred from) current nodes; Edges from Self to other have been omitted (or all nodes would be connected to the central node "self" which is not useful). Nodes are colored by the library they belong to, and scaled with the number of references pointing them


File: /pandas/io/stata.py#1623
type: <class 'function'>
Commit: