1. Python
  2. Python | Pandas DataFrame.to_records

Python | Pandas DataFrame.to_records

DataFrame.to_records() Pandas DataFrame.to_records() converts the DataFrame to an array of NumPy records. The index will be included as the first field in the array of records when requested.

Syntax: DataFrame.to_records (index = True, convert_datetime64 = None, column_dtypes = None, index_dtypes = None )

Parameter:
index: bool, default True
convert_datetime64: Whether to convert the index to datetime.datetime if it is a DatetimeIndex.
column_dtypes: If a string or type, the data type to store all columns
index_dtypes: If a string or type, the data type to store all index levels

Returns: numpy.recarray

Example # 1: Use DataFrame.to_records () to convert this Dataframe to an array of records.

Output:

We will now use DataFrame.to_records () to convert this dataset to a representation of an array of recorded records.

# import pandas as pd

 import pandas as pd

 
# Create DataFrame

df = pd.DataFrame ({ `Weight` : [ 45 , 88 , 56 , 15 , 71 ],

`Name` : [ `Sam` , `Andrea` , ` Alex` , `Robin` , ` Kia` ],

` Age` : [ 14 , 25 , 55 , 8 , 21 ]} )

 
# Create index

index_ = pd.date_range ( `2010-10-09 08:45` , periods = 5 , freq = `H` )

 
# Set index

df.index = index_

  
# Print DataFrame

print (df)

# convert to array of records

result = df.to_records ()

  
# Print result

print (result)

Output:

As we can see in the output, DataFrame.to_records () successfully converted this dataframe to an array of records.

Example # 2: Use DataFrame.to_records () to convert this Dataframe to an array of records.

# pandas import as pd

import pandas as pd

 
# Create DataFrame

df = pd.DataFrame ({ " A " : [ 12 , 4 , 5 , None , 1 ] , 

"B" : [ 7 , 2 , 54 , 3 , None ], 

  "C" : [ 20 , 16 , 11 , 3 , 8 ], 

  " D " : [ 14 , 3 , None , 2 , 6 ]}) 

 
# Create index

index_ = [ `Row_1` , `Row_2` , ` Row_3` , `Row_4` ,  `Row_5` ]

  
# Set index

df.index = index_

  
# Print DataFrame

print (df)

Output:

We will now use DataFrame.to_records () to convert this dataset to a representation of an array of recorded records.

# convert to array of records

result = df.to_records ()

  
# Print result

print (result)

Output:

As we can see in the output, DataFrame.to_records () has successfully converted this dataframe to an array of records.