Current File : //proc/self/root/opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyo
�
� 9Zc @` s7 d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l j
Z
d d l m Z m Z d d l m
Z
d d l m Z d d l m Z d d l m Z e j d d k r� d d
l m Z n e j
j j Z d d d
d d d d d d d d d g Z d � Z d � Z d � Z d � Z e d � Z d d d � Z! d � Z" d � Z# d e$ d � Z% e$ e d � Z& d d! � Z' d" e e e d# � Z( e$ e d$ � Z) d% � Z* d& � Z+ d d" e$ e d' � Z, d d( � Z- d e$ e e d) � Z. d e$ e d* � Z/ d+ d, d- d e$ e d. � Z0 d+ d, d- d d/ � Z1 d S(0 s�
Collection of utilities to manipulate structured arrays.
Most of these functions were initially implemented by John Hunter for
matplotlib. They have been rewritten and extended for convenience.
i ( t divisiont absolute_importt print_functionN( t ndarrayt recarray( t MaskedArray( t
MaskedRecords( t _is_string_like( t
basestringi ( t zipt
append_fieldst drop_fieldst find_duplicatest get_fieldstructuret join_byt merge_arrayst rec_append_fieldst rec_drop_fieldst rec_joint recursive_fill_fieldst
rename_fieldst stack_arraysc C` sz | j } xj | j D]_ } y | | } Wn t k
r= q n X| j j r^ t | | | � q | | | t | � *q W| S( sl
Fills fields from output with fields from input,
with support for nested structures.
Parameters
----------
input : ndarray
Input array.
output : ndarray
Output array.
Notes
-----
* `output` should be at least the same size as `input`
Examples
--------
>>> from numpy.lib import recfunctions as rfn
>>> a = np.array([(1, 10.), (2, 20.)], dtype=[('A', int), ('B', float)])
>>> b = np.zeros((3,), dtype=a.dtype)
>>> rfn.recursive_fill_fields(a, b)
array([(1, 10.0), (2, 20.0), (0, 0.0)],
dtype=[('A', '<i4'), ('B', '<f8')])
( t dtypet namest
ValueErrorR t len( t inputt outputt newdtypet fieldt current( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR " s
c C` sr g } | j } xP | D]H } | | } | j rQ | j | t t | � � f � q | j | � q Wt | � pq d S( s�
Returns the field names of the input datatype as a tuple.
Parameters
----------
adtype : dtype
Input datatype
Examples
--------
>>> from numpy.lib import recfunctions as rfn
>>> rfn.get_names(np.empty((1,), dtype=int)) is None
True
>>> rfn.get_names(np.empty((1,), dtype=[('A',int), ('B', float)]))
('A', 'B')
>>> adtype = np.dtype([('a', int), ('b', [('ba', int), ('bb', int)])])
>>> rfn.get_names(adtype)
('a', ('b', ('ba', 'bb')))
N( R t appendt tuplet get_namest None( t adtypet listnamesR t nameR ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR! I s
"c C` sf g } | j } xD | D]< } | j | � | | } | j r | j t | � � q q Wt | � pe d S( s2
Returns the field names of the input datatype as a tuple. Nested structure
are flattend beforehand.
Parameters
----------
adtype : dtype
Input datatype
Examples
--------
>>> from numpy.lib import recfunctions as rfn
>>> rfn.get_names_flat(np.empty((1,), dtype=int)) is None
True
>>> rfn.get_names_flat(np.empty((1,), dtype=[('A',int), ('B', float)]))
('A', 'B')
>>> adtype = np.dtype([('a', int), ('b', [('ba', int), ('bb', int)])])
>>> rfn.get_names_flat(adtype)
('a', 'b', 'ba', 'bb')
N( R R t extendt get_names_flatR R" ( R# R$ R R% R ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR' h s
c C` s� | j } | d k r | j Sg } xS | D]K } | j | \ } } | j ra | j t | � � q) | j | | f � q) Wt | � Sd S( sD
Flatten a structured data-type description.
Examples
--------
>>> from numpy.lib import recfunctions as rfn
>>> ndtype = np.dtype([('a', '<i4'), ('b', [('ba', '<f8'), ('bb', '<i4')])])
>>> rfn.flatten_descr(ndtype)
(('a', dtype('int32')), ('ba', dtype('float64')), ('bb', dtype('int32')))
N( R R" t descrt fieldsR& t
flatten_descrR R ( t ndtypeR R( R t typt _( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR* � s
c C` s� g } | r6 x� | D] } | j t | j � � q Wnd xa | D]Y } | j } | j pX d } t | � d k r� | j d | j f � q= | j | j � q= Wt j | � j S( s�
Combine the dtype description of a series of arrays.
Parameters
----------
seqarrays : sequence of arrays
Sequence of arrays
flatten : {boolean}, optional
Whether to collapse nested descriptions.
i t ( ( R& R* R R R R R( t np( t seqarrayst flattenR t aR R ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyt zip_descr� s
c C` s� | d k r i } n | j } x� | D]� } | | } | j rz | rT | g | | <n
g | | <| j t | | | � � q% g | j | g � p� g D] } | ^ q� } | r� | j | � n | r� | g } n | p� g | | <q% W| p� d S( sb
Returns a dictionary with fields indexing lists of their parent fields.
This function is used to simplify access to fields nested in other fields.
Parameters
----------
adtype : np.dtype
Input datatype
lastname : optional
Last processed field name (used internally during recursion).
parents : dictionary
Dictionary of parent fields (used interbally during recursion).
Examples
--------
>>> from numpy.lib import recfunctions as rfn
>>> ndtype = np.dtype([('A', int),
... ('B', [('BA', int),
... ('BB', [('BBA', int), ('BBB', int)])])])
>>> rfn.get_fieldstructure(ndtype)
... # XXX: possible regression, order of BBA and BBB is swapped
{'A': [], 'B': [], 'BA': ['B'], 'BB': ['B'], 'BBA': ['B', 'BB'], 'BBB': ['B', 'BB']}
N( R" R t updateR
t getR ( R# t lastnamet parentsR R% R R- t
lastparent( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR
� s"
+ c c` sQ xJ | D]B } t | t j � rD x' t t | � � D] } | Vq2 Wq | Vq Wd S( su
Returns an iterator of concatenated fields from a sequence of arrays,
collapsing any nested structure.
N( t
isinstanceR/ t voidt _izip_fields_flatR ( t iterablet elementt f( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR; � s
c c` s� x� | D]� } t | d � rK t | t � rK xj t | � D] } | Vq9 Wq t | t j � r� t t | � � d k r� x! t | � D] } | Vq� Wq | Vq Wd S( sP
Returns an iterator of concatenated fields from a sequence of arrays.
t __iter__i N( t hasattrR9 R t _izip_fieldsR/ R: R R ( R< R= R> ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyRA � s
* c c` s� | g t | � d j d � } t j | � } g | D] } t j | | � | � ^ q6 } | ri t } n t } y, x% t | � D] } t | | � � Vq WWn t k
r� n Xd S( s*
Returns an iterator of concatenated items from a sequence of arrays.
Parameters
----------
seqarrays : sequence of arrays
Sequence of arrays.
fill_value : {None, integer}
Value used to pad shorter iterables.
flatten : {True, False},
Whether to
i c s` s | � Vd S( s* Yields the fill_value or raises IndexErrorN( ( t counter( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyt sentinel s N(
R t popt itertoolst repeatt chainR; RA R R t
IndexError( R0 t
fill_valueR1 RC t fillerst itt iterst zipfunct tup( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyt izip_records s +
c C` sd t | t � s t } n | r9 | r` | j t � } q` n' t j | � } | r` | j t � } n | S( s�
Private function: return a recarray, a ndarray, a MaskedArray
or a MaskedRecords depending on the input parameters
( R9 R t Falset viewR t mat filledR ( R t usemaskt
asrecarray( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyt _fix_output* s c C` s{ | j j } | j | j | j } } } xK | p5 i j � D]7 \ } } | | k r< | | | <| | | | | <q< q< W| S( sp
Update the fill_value and masked data of `output`
from the default given in a dictionary defaults.
( R R t datat maskRI t items( R t defaultsR RW RX RI t kt v( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyt
_fix_defaults; s
i����c C` s t | � d k r( t j | d � } n t | t t j f � r� | j } | sn t | f d t �| j k r� | j
� } | j s� d | f g } n | r� | r� t } q� t
} n | r� t } n t } | j d | d | � S| f } n" g | D] } t j | � ^ q� } t d � | D� � } t | � } t | d | �}
g } g } | r�x4t | | � D]#\ }
} | | } |
j
� j � } t j |
� j
� } | r9t | |
j � } t | t t j f � rEt | j � d k r�| j � d } t } q6t j | d |
j d d �} t j d d | j �} qEn d } t } | j t j | | g | � � | j t j | | g | � � qbWt t | d | �� } t j t j | d |
d | �d
t t | d | �� �} | r| j t � } qn#x� t | | � D]� \ }
} | | } |
j
� j � } | r�t | |
j � } t | t t j f � r�t | j � d k r�| j � d } q�t j | d |
j d d �} q�n d } | j t j | | g | � � qWt j t t | d | �� d |
d | �} | r| j t � } n | S(
s�
Merge arrays field by field.
Parameters
----------
seqarrays : sequence of ndarrays
Sequence of arrays
fill_value : {float}, optional
Filling value used to pad missing data on the shorter arrays.
flatten : {False, True}, optional
Whether to collapse nested fields.
usemask : {False, True}, optional
Whether to return a masked array or not.
asrecarray : {False, True}, optional
Whether to return a recarray (MaskedRecords) or not.
Examples
--------
>>> from numpy.lib import recfunctions as rfn
>>> rfn.merge_arrays((np.array([1, 2]), np.array([10., 20., 30.])))
masked_array(data = [(1, 10.0) (2, 20.0) (--, 30.0)],
mask = [(False, False) (False, False) (True, False)],
fill_value = (999999, 1e+20),
dtype = [('f0', '<i4'), ('f1', '<f8')])
>>> rfn.merge_arrays((np.array([1, 2]), np.array([10., 20., 30.])),
... usemask=False)
array([(1, 10.0), (2, 20.0), (-1, 30.0)],
dtype=[('f0', '<i4'), ('f1', '<f8')])
>>> rfn.merge_arrays((np.array([1, 2]).view([('a', int)]),
... np.array([10., 20., 30.])),
... usemask=False, asrecarray=True)
rec.array([(1, 10.0), (2, 20.0), (-1, 30.0)],
dtype=[('a', '<i4'), ('f1', '<f8')])
Notes
-----
* Without a mask, the missing value will be filled with something,
* depending on what its corresponding type:
-1 for integers
-1.0 for floating point numbers
'-' for characters
'-1' for strings
True for boolean values
* XXX: I just obtained these values empirically
i i R1 R. R t typec s` s | ] } | j Vq d S( N( t size( t .0R2 ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pys <genexpr>� s t ndmint countRX ( i N(! R R/ t
asanyarrayR9 R R: R R3 t TrueR( t ravelR R R R RQ R t maxR t __array__RR t getmaskarrayt _check_fill_valuet itemt arrayt onesR" R RE RG RO t fromitert list( R0 RI R1 RT RU t seqdtypet seqtypet _mt sizest maxlengthR t seqdatat seqmaskR2 t nt nbmissingRW RX t fvalt fmskR ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR I s| 1 "
$!
$$ c ` s� t | � r | g } n t | � } � f d � � � | j | � } | sO d St j | j d | �} t | | � } t | d | d | �S( sv
Return a new array with fields in `drop_names` dropped.
Nested fields are supported.
Parameters
----------
base : array
Input array
drop_names : string or sequence
String or sequence of strings corresponding to the names of the
fields to drop.
usemask : {False, True}, optional
Whether to return a masked array or not.
asrecarray : string or sequence, optional
Whether to return a recarray or a mrecarray (`asrecarray=True`) or
a plain ndarray or masked array with flexible dtype. The default
is False.
Examples
--------
>>> from numpy.lib import recfunctions as rfn
>>> a = np.array([(1, (2, 3.0)), (4, (5, 6.0))],
... dtype=[('a', int), ('b', [('ba', float), ('bb', int)])])
>>> rfn.drop_fields(a, 'a')
array([((2.0, 3),), ((5.0, 6),)],
dtype=[('b', [('ba', '<f8'), ('bb', '<i4')])])
>>> rfn.drop_fields(a, 'ba')
array([(1, (3,)), (4, (6,))],
dtype=[('a', '<i4'), ('b', [('bb', '<i4')])])
>>> rfn.drop_fields(a, ['ba', 'bb'])
array([(1,), (4,)],
dtype=[('a', '<i4')])
c ` s� | j } g } xt | D]l } | | } | | k r8 q n | j ro � | | � } | r� | j | | f � q� q | j | | f � q W| S( N( R R ( R+ t
drop_namesR R R% R R( ( t _drop_descr( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR{ � s
R RT RU N( R t setR R" R/ t emptyt shapeR RV ( t baseRz RT RU R R ( ( R{ sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR � s # c C` s t | | d t d t �S( sK
Returns a new numpy.recarray with fields in `drop_names` dropped.
RT RU ( R RP Rd ( R Rz ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR s c ` s. � f d � � � | j | � } | j | � S( s�
Rename the fields from a flexible-datatype ndarray or recarray.
Nested fields are supported.
Parameters
----------
base : ndarray
Input array whose fields must be modified.
namemapper : dictionary
Dictionary mapping old field names to their new version.
Examples
--------
>>> from numpy.lib import recfunctions as rfn
>>> a = np.array([(1, (2, [3.0, 30.])), (4, (5, [6.0, 60.]))],
... dtype=[('a', int),('b', [('ba', float), ('bb', (float, 2))])])
>>> rfn.rename_fields(a, {'a':'A', 'bb':'BB'})
array([(1, (2.0, [3.0, 30.0])), (4, (5.0, [6.0, 60.0]))],
dtype=[('A', '<i4'), ('b', [('ba', '<f8'), ('BB', '<f8', 2)])])
c ` su g } xh | j D]] } | j | | � } | | } | j rZ | j | � | | � f � q | j | | f � q W| S( N( R R5 R ( R+ t
namemapperR R% t newnameR ( t _recursive_rename_fields( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR� 0 s
( R RQ ( R R� R ( ( R� sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR s c
C` sv t | t t f � rE t | � t | � k ri d } t | � � qi n$ t | t � ri | g } | g } n | d k r� g | D]! } t j | d t d t
�^ q| } g t | | � D]' \ } } | j | | j
f g � ^ q� } n� t | t t f � s| g } n t | � t | � k rVt | � d k rA| t | � } qVd } t | � � n g t | | | � D]B \ } }
} t j | d t d t
d | �j |
| f g � ^ qi} t | d | d | �} t | � d k r�t | d t
d | d | �} n | j � } t j t t | � t | � � d | j
j | j
j �} t | | � } t | | � } t | d | d
| �S( s
Add new fields to an existing array.
The names of the fields are given with the `names` arguments,
the corresponding values with the `data` arguments.
If a single field is appended, `names`, `data` and `dtypes` do not have
to be lists but just values.
Parameters
----------
base : array
Input array to extend.
names : string, sequence
String or sequence of strings corresponding to the names
of the new fields.
data : array or sequence of arrays
Array or sequence of arrays storing the fields to add to the base.
dtypes : sequence of datatypes, optional
Datatype or sequence of datatypes.
If None, the datatypes are estimated from the `data`.
fill_value : {float}, optional
Filling value used to pad missing data on the shorter arrays.
usemask : {False, True}, optional
Whether to return a masked array or not.
asrecarray : {False, True}, optional
Whether to return a recarray (MaskedRecords) or not.
s7 The number of arrays does not match the number of namest copyt suboki s5 The dtypes argument must be None, a dtype, or a list.R RT RI R1 RU N( R9 R Rn R R R R" R/ Rk RP Rd R RQ R R RD RR t
masked_allRf R( R RV (
R R RW t dtypesRI RT RU t msgR2 R% Rv t dR ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR
@ s: .@ X !c C` s% t | | d | d | d t d t �S( sM
Add new fields to an existing array.
The names of the fields are given with the `names` arguments,
the corresponding values with the `data` arguments.
If a single field is appended, `names`, `data` and `dtypes` do not have
to be lists but just values.
Parameters
----------
base : array
Input array to extend.
names : string, sequence
String or sequence of strings corresponding to the names
of the new fields.
data : array or sequence of arrays
Array or sequence of arrays storing the fields to add to the base.
dtypes : sequence of datatypes, optional
Datatype or sequence of datatypes.
If None, the datatypes are estimated from the `data`.
See Also
--------
append_fields
Returns
-------
appended_array : np.recarray
RW R� RU RT ( R
Rd RP ( R R RW R� ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR � s c C` s t | t � r | St | � d k r- | d Sg | D] } t j | � j � ^ q4 } g | D] } t | � ^ q\ } g | D] } | j ^ q{ } g | D] } | j ^ q� }
| d } | j } g | D] }
|
d ^ q� } x| d D]} x� | j D]� } | d p
d } | | k r6| j | � | j | � q� | j
| � } | | } | r�t j | d � t j | d � k r�t | � } | d | d <t | � | | <q�q� | d | d k r� t
d t | � | | d f � � q� q� Wq� Wt | � d k rt j | � } n� t j t j | � f | � } t j t j d | f � } g } x� t | |
| d | d � D]� \ } } } } | j j } | d k r�| | d t | � | | +qpx? | D]7 } | | | | | | +| | k r�| j | � q�q�WqpWt t | | � d | d | �S(
s�
Superposes arrays fields by fields
Parameters
----------
arrays : array or sequence
Sequence of input arrays.
defaults : dictionary, optional
Dictionary mapping field names to the corresponding default values.
usemask : {True, False}, optional
Whether to return a MaskedArray (or MaskedRecords is
`asrecarray==True`) or a ndarray.
asrecarray : {False, True}, optional
Whether to return a recarray (or MaskedRecords if `usemask==True`)
or just a flexible-type ndarray.
autoconvert : {False, True}, optional
Whether automatically cast the type of the field to the maximum.
Examples
--------
>>> from numpy.lib import recfunctions as rfn
>>> x = np.array([1, 2,])
>>> rfn.stack_arrays(x) is x
True
>>> z = np.array([('A', 1), ('B', 2)], dtype=[('A', '|S3'), ('B', float)])
>>> zz = np.array([('a', 10., 100.), ('b', 20., 200.), ('c', 30., 300.)],
... dtype=[('A', '|S3'), ('B', float), ('C', float)])
>>> test = rfn.stack_arrays((z,zz))
>>> test
masked_array(data = [('A', 1.0, --) ('B', 2.0, --) ('a', 10.0, 100.0) ('b', 20.0, 200.0)
('c', 30.0, 300.0)],
mask = [(False, False, True) (False, False, True) (False, False, False)
(False, False, False) (False, False, False)],
fill_value = ('N/A', 1e+20, 1e+20),
dtype = [('A', '|S3'), ('B', '<f8'), ('C', '<f8')])
i i R. i����s Incompatible type '%s' <> '%s's f%iRT RU N( R9 R R R/ Rc Re R R R( R t indexRn R t TypeErrort dictRR t concatenateR� t sumt cumsumt r_R R" RV R] ( t arraysRZ RT RU t autoconvertR2 R0 t nrecordsR+ R� t fldnamest dtype_lt newdescrR- R t dtype_nR( R% t nameidxt
current_descrR t offsett seenRv t it j( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR � sT '(
& ) 0
c
C` s
t j | � j � } t | j � } | } | r\ x | | D] } | | } q; W| | } n | j � } | | } | j � } | d | d k }
| r� | j } t |
| d <n t j t g |
f � }
|
d |
d |
d *| | |
} | r| | |
f S| Sd S( sa
Find the duplicates in a structured array along a given key
Parameters
----------
a : array-like
Input array
key : {string, None}, optional
Name of the fields along which to check the duplicates.
If None, the search is performed by records
ignoremask : {True, False}, optional
Whether masked data should be discarded or considered as duplicates.
return_index : {False, True}, optional
Whether to return the indices of the duplicated values.
Examples
--------
>>> from numpy.lib import recfunctions as rfn
>>> ndtype = [('a', int)]
>>> a = np.ma.array([1, 1, 1, 2, 2, 3, 3],
... mask=[0, 0, 1, 0, 0, 0, 1]).view(ndtype)
>>> rfn.find_duplicates(a, ignoremask=True, return_index=True)
... # XXX: judging by the output, the ignoremask flag has no effect
i����i N(
R/ Rc Re R
R t argsortRS t
recordmaskRP R� (
R2 t keyt
ignoremaskt return_indexR) R R> t sortidxt
sortedbaset
sorteddatat flagt
sortedmaskt
duplicates( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR s(
t innert 1t 2c ) ` s | d k r t d | � � n t � t � r: � f � n xX � D]P } | | j j k rl t d | � � n | | j j k rA t d | � � qA qA W| j � } | j � } t | � }
| j j | j j } } t j t | � t | � � j � � r%| p| r%d }
|
d 7}
t |
� � n t
| g | D] } | � k r2| ^ q2� } t
| g | D] } | � k r`| ^ q`� } t j | | f � } | j
d � � } | | } t j t g | d
| d k f � } | d
| d | d *| | } | | |
k } | | |
k |
} t | � t | � } } | d k rPd \ } } n� | d k r�| | } t j | | | |
k f � } t j | | | |
k |
f � } t | � | t | � | } } nP | d k r | | } t j | | | |
k f � } t | � | d } } n | | | | } } g | j j D] } t | � ^ q?} | j � f d
� | j j D� � t d � | D� � } x� | j j D]� }! t |! � }! |! d } | | k r?| j |! � }" | |" }# | � k rt |! d
|# d � |# d <q]|# d c | 7<|! d c | 7<| j |" d
|! � q�| j |! d � | j |! � q�Wg | D] } t | � ^ qh} t | | � }$ t j |$ | | f d | �}% |% j j } x� | D]� }& | |& }' |& | k s�|& | k r
| r
|& � k r
|& | 7}& n |% |& }# |' | |# | *| d k r�|' | |# |$ |$ | +q�q�Wx� | D]� }& | |& }' |& | k s�|& | k r�| r�|& � k r�|& | 7}& n |% |& }# |' | |# | *| d k rQ| rQ|' | |# | )qQqQW|% j d � � t d | d | � }( t t |% | � |( � S( s<
Join arrays `r1` and `r2` on key `key`.
The key should be either a string or a sequence of string corresponding
to the fields used to join the array. An exception is raised if the
`key` field cannot be found in the two input arrays. Neither `r1` nor
`r2` should have any duplicates along `key`: the presence of duplicates
will make the output quite unreliable. Note that duplicates are not
looked for by the algorithm.
Parameters
----------
key : {string, sequence}
A string or a sequence of strings corresponding to the fields used
for comparison.
r1, r2 : arrays
Structured arrays.
jointype : {'inner', 'outer', 'leftouter'}, optional
If 'inner', returns the elements common to both r1 and r2.
If 'outer', returns the common elements as well as the elements of
r1 not in r2 and the elements of not in r2.
If 'leftouter', returns the common elements and the elements of r1
not in r2.
r1postfix : string, optional
String appended to the names of the fields of r1 that are present
in r2 but absent of the key.
r2postfix : string, optional
String appended to the names of the fields of r2 that are present
in r1 but absent of the key.
defaults : {dictionary}, optional
Dictionary mapping field names to the corresponding default values.
usemask : {True, False}, optional
Whether to return a MaskedArray (or MaskedRecords is
`asrecarray==True`) or a ndarray.
asrecarray : {False, True}, optional
Whether to return a recarray (or MaskedRecords if `usemask==True`)
or just a flexible-type ndarray.
Notes
-----
* The output is sorted along the key.
* A temporary array is formed by dropping the fields not in the key for
the two arrays and concatenating the result. This array is then
sorted, and the common entries selected. The output is constructed by
filling the fields with the selected entries. Matching is not
preserved if there are some duplicates...
R� t outert leftoutersW The 'jointype' argument should be in 'inner', 'outer' or 'leftouter' (got '%s' instead)s r1 does not have key field %ss r2 does not have key field %ss8 r1 and r2 contain common names, r1postfix and r2postfix s can't be emptyt orderi i����i c 3` s+ | ]! } | d � k r t | � Vq d S( i N( Rn ( R` R- ( R� ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pys <genexpr>� s c s` s | ] } | d Vq d S( i N( ( R` R- ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pys <genexpr>� s R RT RU ( R� R� R� ( i i ( R� R� ( R R9 R R R Re R R| t intersectiont
differenceR RR R� R� RP R/ R( Rn R& R� Rf t insertR R R� t sortR� RV R] () R� t r1t r2t jointypet r1postfixt r2postfixRZ RT RU R% t nb1t r1namest r2namesR� Rv t r1kt r2kt auxt idx_sortt flag_int idx_int idx_1t idx_2t r1cmnt r2cmnt r1spct r2spct idx_outt s1t s2R- R+ R t descR� R t cmnR R> t selectedt kwargs( ( R� sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR 7 s� 3
'
..
&
#$ %#
+
+
c
C` s@ t d | d | d | d | d t d t � } t | | | | � S( s�
Join arrays `r1` and `r2` on keys.
Alternative to join_by, that always returns a np.recarray.
See Also
--------
join_by : equivalent function
R� R� R� RZ RT RU ( R� RP Rd R ( R� R� R� R� R� R� RZ R� ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyR � s
(2 t __doc__t
__future__R R R t sysRE t numpyR/ t numpy.maRR R R R t numpy.ma.mrecordsR t numpy.lib._iotoolsR t numpy.compatR t version_infot future_builtinsR t coreRi t __all__R R! R' R* RP R3 R" R
R; RA Rd RO RV R] R R R R R
R R R R R ( ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/numpy/lib/recfunctions.pyt <module> sV ' / ! �@ 'D " Y6 �
Mini Shell