read_data

paleokalmag.read_data(fname, rejection_lists=None, update_mex=True)

Read a file produced by the GEOMAGIA database and return a pandas.Dataframe

Parameters:

• fname (str) – Path to a file containing paleomagnetic data. It will be assumed to point to a file from GEOMAGIA.

• rejection_lists (array or list of arrays, optional) – An array (or list of arrays) of types {‘D’, ‘I’, ‘F’}, indices, and file hashes, which uniquely identify records to be dropped from the data. (Outlier rejection). Default is None.

• update_mex (bool, optional) – Whether to update some Mexico data according to personal communication with Ahmed Nasser Mahgoub Ahmed (2022).

Returns:

A dataframe containing the data. The following keys are included:

t : the measurement dates in yrs dt : the dating uncertainties in yrs rad : the radius of the measurement location in km colat : the colatitude of the measurement location in deg lat : the latitude of the measurement location in deg lon : the longitude of the measurement location in deg D : declination measurement in deg dD : error of the declination measurement in deg I : incination measurement in deg dI : error of the inlcination measurement in deg F : intensity measurement in uT dF : error of the intensity measurement in uT UID : unique ID identifying each record in a dataset FID : sha256 hash of the file the record stems from

Return type:

DataFrame