3
���h?h � @ s d Z ddlZddlZddlmZmZmZmZmZ ddl
m Z m
Z ejjjZddljZddlmZmZmZmZmZmZmZmZ ejj Z dddd d
d gZ d d
ddgZ d"dd�Z dd� Z G dd� de�Z!dd� Z"e!Z#d#dd�Z ddddddddef dd �Z
dd� Z$d d � Z%d$d d
�Z&d%d!d �Z'dS )&a, :mod:`numpy.ma..mrecords`
Defines the equivalent of :class:`numpy.recarrays` for masked arrays,
where fields can be accessed as attributes.
Note that :class:`numpy.ma.MaskedArray` already supports structured datatypes
and the masking of individual fields.
.. moduleauthor:: Pierre Gerard-Marchant
� N)�bool_�dtype�ndarray�recarray�array)�
fromarrays� fromrecords)�MAError� MaskedArray�masked�nomask� masked_array�getdata� getmaskarray�filled�
MaskedRecords� mrecarrayr r � fromtextfile�addfield�_data�_mask�
_fieldmaskr c C s� t | �}dd� t|�D �}|dkr(|}nZt|ttf�r<|}n&t|t�rR|jd�}ntdt|� ��t |�}||k r�|||d� 7 }g }xbt ||| j
�D ]P\}}}|t kr�|d t kr�|j ||d f� q�|j |� q�|j ||d f� q�W t
j|�S )z�
Checks that field names ``descr`` are not reserved keywords.
If this is the case, a default 'f%i' is substituted. If the argument
`names` is not None, updates the field names to valid names.
c S s g | ] }d | �qS )zf%i� )�.0�ir r �2/tmp/pip-build-5_djhm0z/numpy/numpy/ma/mrecords.py�
<listcomp>6 s z _checknames.<locals>.<listcomp>N�,zillegal input names %sr � )�len�range�
isinstance�tuple�list�str�split� NameError�repr�zip�descr�reserved_fields�append�npr ) r) �namesZndescrZ
default_namesZ new_namesZnnames�n�d�tr r r � _checknames- s(
r1 c C s: dd� | j jD �}tj| j|d�}tdgt|� �|_|S )Nc S s g | ] }|d f�qS )z|b1r )r r. r r r r P s z"_get_fieldmask.<locals>.<listcomp>)r F)r r- r, �empty�shaper" r �flat)�self�mdescrZfdmaskr r r �_get_fieldmaskO s r7 c @ s� e Zd ZdZdddddddddeddddfdd�Zdd � Zed
d � �Zed d
� �Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zd,d d �Zd d � Zd d!� Zd"d#� Zd-d$d%�Zd&d'� Zd(d)� Zd*d+� ZdS ).r a�
Attributes
----------
_data : recarray
Underlying data, as a record array.
_mask : boolean array
Mask of the records. A record is masked when all its fields are
masked.
_fieldmask : boolean recarray
Record array of booleans, setting the mask of each individual field
of each record.
_fill_value : record
Filling values for each field.
Nr FTc
s t j| ||||||||| |
d� }tj|j�� | tks@tj| � rZ|sXtdgt � � �|_
n�tj | |d�} | j |j kr�|j| j }}|dkr�tj
| |j �} n,||kr�tj| |j �} nd }t|||f ��d}|s�|j| � d|_n2| j� kr�| }n tj � fdd �| D �� d
�}||_
|S ) N) r �buf�offset�strides�formatsr- �titles� byteorder�alignedF)�copyr z/Mask and data not compatible: data size is %i, zmask size is %i.Tc s g | ]}t |gt� � ��qS r )r" r )r �m)�mdtyper r r � s z)MaskedRecords.__new__.<locals>.<listcomp>)r z?Mask and data not compatible: data size is %i, mask size is %i.)r �__new__�ma�make_mask_descrr r r, �sizer" r r r r3 �resizeZreshaper � __setmask__� _sharedmask)�clsr3 r r8 r9 r: r; r- r< r= r> �maskZ hard_mask�
fill_valueZ keep_maskr? �optionsr5 Znd�nm�msgr r )rA r rB h s8
zMaskedRecords.__new__c s� t |dd �}|d krpt |dt�}tj| d�}|tkrFtj| j|d�}n*tj|�� t� fdd�|D �� d�j t
�}| j }|j |d� | j
|� |d tkr�t
|d< d S )Nr r )r c s g | ]}t |gt� � ��qS r )r" r )r r@ )r6 r r r � s z4MaskedRecords.__array_finalize__.<locals>.<listcomp>)r �
_baseclass)�getattrr r �__getattribute__rC Zmake_mask_noner3 rD �narray�viewr �__dict__�update� _update_from)r5 �objr ZobjmaskZ_dtype�_dictr )r6 r �__array_finalize__� s
z MaskedRecords.__array_finalize__c C s t j| t�S )z2
Returns the data as a recarray.
)r rS r )r5 r r r r � s zMaskedRecords._datac C s | j S )z!
Alias to mask.
)r )r5 r r r r � s zMaskedRecords._fieldmaskc C s | j rt| j�S t| j�S )z%
Returns the length
)�ndimr r r )r5 r r r �__len__� s
zMaskedRecords.__len__c # C s� y t j| |�S tk
r Y nX tj| d�j}y|| d d� }W n$ ttfk
rh td| ��Y nX tj| d�}tj| |d �}|j|� }|j j
d k r�t d��d}|j dd �}|d k �ry || }W n t
k
r� Y nX t|j �} |jt| r�| fnf f�j� }|j�s|�rt|jt�}t|_d |_||_|j d
d �}
|
d k �r|y|
| |_W n tk
�rp d |_Y nX n|j� }|S ) Nr � z record array has no attribute %srT rO z4MaskedRecords is currently limited tosimple records.Fr T� _fill_value)�objectrQ �AttributeErrorr �fields� TypeError�KeyErrorrS �getfieldr r- �NotImplementedError�get�
IndexErrorr �bool�anyr3 r
rO Z_isfieldr r] �
ValueError�item) r5 �attr� fielddict�res�
_localdictr rW Z hasmaskedr Ztp_lenr] r r r rQ � sH
z MaskedRecords.__getattribute__c
C sz |d
kr| j |� dS tj| d�}||k}ytj| ||�}W nH tk
r� tj| d�jp\i }tj| d�pli }||kp|||ks�� Y nJX tj| d�jp�i }||kr�|S |r�ytj| |� W n tk
r� |S X y|| dd� }W n& tt fk
�r t
d| ��Y nX |t k�r>|d } | dk �r4|d | }
n|}
d
} nt |�}
t
|�} tj| d �j|
f|�� } |d j|| � | S )z<
Sets the attribute attr to the value val.
rJ � fieldmaskNrT r Z_optinfor\ z record array has no attribute %sr] Tr r )rJ ro )rG r^ rQ � __setattr__� Exceptionr r` � __delattr__ra rb r_ r r r �setfield� __setitem__)
r5 rk �valrn Znewattr�retrl Zoptinform r] �dvalZmvalrW r r r rp � sF
zMaskedRecords.__setattr__c C s� | j }tj| d�}tj| |d �}t|t�rz|| jt�}|| |_d|_|d }|dk rd|| |_ |j
rv|jrvt S |S t j
|| dd�jt�}t j
|| dd�jt�|_|S )z�
Returns all the fields sharing the same fieldname base.
The fieldname base is either `_data` or `_mask`.
r rO Tr] NF)r? )rT r rQ rS r! r$ r
r rH r] rZ r r, r r r )r5 �indxrn r r rW Zfvalr r r � __getitem__% s
zMaskedRecords.__getitem__c C s, t j| ||� t|t�r(tj|�| j|< dS )z2
Sets the given record to value.
N)r
rt r! r$ rC r r )r5 rx �valuer r r rt E s
zMaskedRecords.__setitem__c sr � j dkr<dd� t� fdd�� jjD �� D �}ddj|� S dd� t� fdd�� jjD ��D �}d dj|� S d
S ) z8
Calculates the string representation.
r c S s$ g | ] }d dj dd� |D �� �qS )z(%s)r c S s g | ] }t |��qS r )r$ )r r r r r r T s z4MaskedRecords.__str__.<locals>.<listcomp>.<listcomp>)�join)r �sr r r r T s z)MaskedRecords.__str__.<locals>.<listcomp>c s g | ]}t � |��qS r )rP )r �f)r5 r r r U s z[%s]z, c S s$ g | ] }d dj dd� |D �� �qS )z%sr c S s g | ] }t |��qS r )r$ )r r r r r r X s z4MaskedRecords.__str__.<locals>.<listcomp>.<listcomp>)r{ )r r| r r r r X s c s g | ]}t � |��qS r )rP )r r} )r5 r r r Y s z(%s)N)rE r( r r- r{ )r5 Zmstrr )r5 r �__str__N s
zMaskedRecords.__str__c sn �j j}dtdd� |D ��d f � � �fdd��j jD �}|jdd� |j� d�jf d g� td
j|��S ) z6
Calculates the repr representation.
z %%%is : %%sc S s g | ] }t |��qS r )r )r r. r r r r b s z*MaskedRecords.__repr__.<locals>.<listcomp>� c s g | ]}� |t �|�f �qS r )rP )r r} )�fmtr5 r r r c s r zmasked_records(z fill_valuez )�
)r r- �max�insert�extendrK r$ r{ )r5 Z_namesZreprstrr )r� r5 r �__repr__\ s zMaskedRecords.__repr__c C s |dkr*|dkr t j| �}q�t j| |�}n�|dkr�y,t|t �rPt j| |�}d}n t j| |�}W q� tk
r� tj|�}|jdkr�| jjd }| j � j||�}|j
| � n t j| |�}d|_ Y q�X nt j| ||�}t |dt
�t
k �r
tj|j�}| jj|t �|_|j|j_|S )z3
Returns a view of the mrecarray.
Nr r )r rS �
issubclassra r, r r` � __class__� __bases__Z __array__rV r] rP r rC rD r r3 )r5 r �type�output�basetyperA r r r rS i s0
zMaskedRecords.viewc C s
d| _ dS )z+
Forces the mask to hard.
TN)� _hardmask)r5 r r r � harden_mask� s zMaskedRecords.harden_maskc C s
d| _ dS )z*
Forces the mask to soft
FN)r� )r5 r r r � soften_mask� s zMaskedRecords.soften_maskc C s$ | j j� jt| ��}| jj� |_|S )z7
Returns a copy of the masked record.
)r r? rS r� r )r5 �copiedr r r r? � s zMaskedRecords.copyc C sH |dk r| j |�j� S t| j � j� td�}t| jj� �}d||< |j� S )a
Return the data portion of the array as a list.
Data items are converted to the nearest compatible Python type.
Masked values are converted to fill_value. If fill_value is None,
the corresponding entries in the output list will be ``None``.
N)r )r �tolistrR r^ r )r5 rK �resultrJ r r r r� � s zMaskedRecords.tolistc C s, d| j | j| jj| jj� | jj� | jf}|S )zWReturn the internal state of the masked array.
This is for pickling.
r )r3 r �flagsZfncr �tobytesr r] )r5 �stater r r � __getstate__� s zMaskedRecords.__getstate__c
C s^ |\}}}}}}}t j| ||||f� tdd� | jjD ��} | jd j|| ||f� || _dS )at
Restore the internal state of the masked array.
This is for pickling. ``state`` is typically the output of the
``__getstate__`` output, and is a 5-tuple:
- class name
- a tuple giving the shape of the data
- a typecode for the data
- a binary string for the data
- a binary string for the mask.
c S s g | ]\}}|t f�qS r )r )r �k�_r r r r � s z.MaskedRecords.__setstate__.<locals>.<listcomp>r N)r � __setstate__r r) rT rK )
r5 r� �verZshp�typZisf�rawZmskZflvrA r r r r� � s
zMaskedRecords.__setstate__c C s t | j| jddf| j� fS )z?
Return a 3-tuple for pickling a MaskedArray.
r �b)r )�_mrreconstructr� rO r� )r5 r r r �
__reduce__� s zMaskedRecords.__reduce__)NN)N)�__name__�
__module__� __qualname__�__doc__r rB rY �propertyr r r[ rQ rp ry rt r~ r� rS r� r� r? r� r� r� r� r r r r r V s0 % .7
)
c C s4 t j|||�j| �}t jt |d�}| j| |||d�S )zK
Build a new MaskedArray from the information stored in a pickle.
Zb1)rJ r )r rB rS )�subtypeZ baseclassZ baseshaper� r r r r r r� � s r� Fc
C s\ dd� | D �} dd� | D �}
t | |||||||d�jt�} tt|
� �| j_|dk rX|| _| S )a
Creates a mrecarray from a (flat) list of masked arrays.
Parameters
----------
arraylist : sequence
A list of (masked) arrays. Each element of the sequence is first converted
to a masked array if needed. If a 2D array is passed as argument, it is
processed line by line
dtype : {None, dtype}, optional
Data type descriptor.
shape : {None, integer}, optional
Number of records. If None, shape is defined from the shape of the
first array in the list.
formats : {None, sequence}, optional
Sequence of formats for each individual field. If None, the formats will
be autodetected by inspecting the fields and selecting the highest dtype
possible.
names : {None, sequence}, optional
Sequence of the names of each field.
fill_value : {None, sequence}, optional
Sequence of data to be used as filling values.
Notes
-----
Lists of tuples should be preferred over lists of lists for faster processing.
c S s g | ] }t |��qS r )r )r �xr r r r s z fromarrays.<locals>.<listcomp>c S s g | ]}t jt|���qS r )r, Z
atleast_1dr )r r� r r r r s )r r3 r; r- r< r> r= N)�
recfromarraysrS r r# r( r r4 rK ) Z arraylistr r3 r; r- r< r> r= rK ZdatalistZmasklistZ_arrayr r r r � s c
C s� t | dd�}
t| t�rDt| t�r.| j� jt�} |dkr<| j}| j� } t| |||||||d�jt �} |dk rp|| _
| t k r�t j
| dd�} t| j�} | r�| | j_n(| jdkr�dd� | D �| j_n
| j| � |
dk r�|
| jdd�< | S ) aN
Creates a MaskedRecords from a list of records.
Parameters
----------
reclist : sequence
A list of records. Each element of the sequence is first converted
to a masked array if needed. If a 2D array is passed as argument, it is
processed line by line
dtype : {None, dtype}, optional
Data type descriptor.
shape : {None,int}, optional
Number of records. If None, ``shape`` is defined from the shape of the
first array in the list.
formats : {None, sequence}, optional
Sequence of formats for each individual field. If None, the formats will
be autodetected by inspecting the fields and selecting the highest dtype
possible.
names : {None, sequence}, optional
Sequence of the names of each field.
fill_value : {None, sequence}, optional
Sequence of data to be used as filling values.
mask : {nomask, sequence}, optional.
External mask to apply on the data.
Notes
-----
Lists of tuples should be preferred over lists of lists for faster processing.
r N)r r3 r; r- r< r> r= F)r? r\ c S s g | ] }t |��qS r )r" )r r@ r r r r [ s z fromrecords.<locals>.<listcomp>)rP r! r r
r rS r r� �recfromrecordsr rK r r, r r r r4 rZ rG )
Zreclistr r3 r; r- r< r> r= rK rJ r ZmrecZmaskrecordlengthr r r r " s. "
c C s� g }t j| �} | jdkr"| d } n| jdkr4td��x�| D ]�}y t|� W n� ttfk
r� y t|� W nZ ttfk
r� y t|� W n$ ttfk
r� |j| j � Y nX |jt j t�� Y nX |jt j t�� Y q:X |jt j t�� q:W |S )a.
Tries to guess the dtypes of the str_ ndarray `arr`.
Guesses by testing element-wise conversion. Returns a list of dtypes.
The array is first converted to ndarray. If the array is 2D, the test
is performed on the first line. An exception is raised if the file is
3D or more.
r\ r z The array should be 2D at most!)
r, ZasarrayrZ ri �intra �float�complexr+ r )Zarr�vartypesr} r r r �_guessvartypesc s*
r� c C st t | d�r| S y t| �}W n tk
r: td| ��Y nX |j� dd� dkr`|jdd� |S |j� td��dS )z1
Opens the file handle of file `fname`.
�readlinezNo such file: '%s'Nr\ z\xr zWow, binary file)�hasattr�open�IOErrorr� �seek�closerd )�fnamer} r r r �openfile� s
r� �#� c s. t | �}x:|j� }|d|j� �� j� }|j��} t| �dkr
P q
W |dkrP| }t� �fdd�|D ��}
|
j\} } |j� |dkr�t |
d �}nLdd� |D �}t|�| kr�d}
|
d7 }
t
j |
t|�| f d d
� t |
d �}d d� t ||�D �}d d� |D �}|
j
|k}d
d� t |
j
|||�D �}t||d�S )a�
Creates a mrecarray from data stored in the file `filename`.
Parameters
----------
fname : {file name/handle}
Handle of an opened file.
delimitor : {None, string}, optional
Alphanumeric character used to separate columns in the file.
If None, any (group of) white spacestring(s) will be used.
commentchar : {'#', string}, optional
Alphanumeric character used to mark the start of a comment.
missingchar : {'', string}, optional
String indicating missing data, and used to create the masks.
varnames : {None, sequence}, optional
Sequence of the variable names. If None, a list will be created from
the first non empty line of the file.
vartypes : {None, sequence}, optional
Sequence of the variables dtypes. If None, it will be estimated from
the first non-commented line.
Ultra simple: the varnames are in the header, one lineNr c s2 g | ]*}|d � krt |�dkr|j� j���qS )r r )r �stripr% )r �line)� commentchar� delimitorr r r � s z fromtextfile.<locals>.<listcomp>r c S s g | ]}t j|��qS r )r, r )r �vr r r r � s z&Attempting to %i dtypes for %i fields!z Reverting to default.r\ )�
stacklevelc S s g | ]\}}||f�qS r r )r r. r} r r r r � s c S s g | ]}t j|��qS r )rC Zdefault_fill_value)r r} r r r r � s c S s$ g | ] \}}}}t ||||d ��qS ))rJ r rK )r
)r �ar@ r0 r} r r r r � s )r )r� r� �findr� r% r r
r3 r� r� �warnings�warnr( �Tr )r� r� r� Z missingcharZvarnamesr� Zftextr� � firstlineZ _varnamesZ
_variablesr� ZnfieldsrN r6 Zmfillvr Z _datalistr )r� r� r r � s4
c s� | j � | j�|dks |tkr*dt� j� }tj|�}tj� jj||jfg �}t � j
|��� �fdd�� jj j � D � �j
|j f�jj | �� �jt��tjdd� |jD ��}t � j
|����fdd��jj j � D � �j
t|�f�jj | �� ��_�S )z�Adds a new field to the masked record array
Uses `newfield` as data and `newfieldname` as name. If `newfieldname`
is None, the new field name is set to 'fi', where `i` is the number of
existing fields.
Nzf%ic s" g | ]}�j � j|� f|�� �qS r )rs rc )r r} )r �newdatar r r � s z addfield.<locals>.<listcomp>c S s g | ] }|t f�qS r )r )r r. r r r r � s c s" g | ]}�j � j|� f|�� �qS r )rs rc )r r} )r �newmaskr r r � s )r r r* r r rC r r, r) r r3 r` �valuesrs rS r r- r )ZmrecordZnewfieldZ newfieldnameZnewdtypeZ newmdtyper )r r r� r� r r � s&
)N)NNNNNFNN)Nr� r� NN)N)(r� r� Znumpyr, r r r r r rR Znumpy.core.recordsr r� r r� �core�recordsZ_byteorderconvZnumpy.marC r r
r r r
r r r Z_check_fill_value�__all__r* r1 r7 r r� r r� r� r r r r r r �<module>
s<
(
"
)?%
C |