NumPy
keyboard_arrow_down 319 guides
chevron_leftDocumentation
Method argpartition
NumPy Random Generator4 topics
Method choiceMethod dotMethod finfoMethod histogramMethod iinfoMethod maxMethod meanMethod placeMethod rootsMethod seedMethod uniformMethod viewMethod zerosMethod sumObject busdaycalendarMethod is_busdayProperty dtypeMethod uniqueMethod loadtxtMethod vsplitMethod fliplrMethod setdiff1dMethod msortMethod argsortMethod lexsortMethod aroundMethod nanmaxMethod nanminMethod nanargmaxMethod nanargminMethod argmaxMethod argminProperty itemsizeMethod spacingMethod fixMethod ceilMethod diffProperty flatProperty realProperty baseMethod flipMethod deleteMethod amaxMethod aminMethod logical_xorMethod logical_orMethod logical_notMethod logical_andMethod logaddexpMethod logaddexp2Method logspaceMethod not_equalMethod equalMethod greater_equalMethod lessMethod less_equalMethod remainderMethod modMethod emptyMethod greaterMethod isfiniteMethod busday_countMethod repeatMethod varMethod random_sampleMethod randomMethod signMethod stdMethod absoluteMethod absMethod sortMethod randintMethod isrealMethod linspaceMethod gradientMethod allMethod sampleProperty TProperty imagMethod covMethod insertMethod logMethod log1pMethod exp2Method expm1Method expMethod arccosMethod cosMethod arcsinMethod sinMethod tanMethod fromiterMethod trim_zerosMethod diagflatMethod savetxtMethod count_nonzeroProperty sizeProperty shapeMethod reshapeMethod resizeMethod triuMethod trilMethod eyeMethod arangeMethod fill_diagonalMethod tileMethod saveMethod transposeMethod swapaxesMethod meshgridProperty mgridMethod rot90Method log2Method radiansMethod deg2radMethod rad2degMethod degreesMethod log10Method appendMethod cumprodProperty nbytesMethod tostringProperty dataMethod modfMethod fmodMethod tolistMethod datetime_as_stringMethod datetime_dataMethod array_splitMethod itemsetMethod floorMethod put_along_axisMethod cumsumMethod bincountMethod putMethod putmaskMethod takeMethod hypotMethod sqrtMethod squareMethod floor_divideMethod triMethod signbitMethod flattenMethod ravelMethod rollMethod isrealobjMethod diagMethod diagonalMethod quantileMethod onesMethod iscomplexobjMethod iscomplexMethod isscalarMethod divmodMethod isnatMethod percentileMethod isnanMethod divideMethod addMethod reciprocalMethod positiveMethod subtractMethod medianMethod isneginfMethod isposinfMethod float_powerMethod powerMethod negativeMethod maximumMethod averageMethod isinfMethod multiplyMethod busday_offsetMethod identityMethod interpMethod squeezeMethod get_printoptionsMethod savez_compressedMethod savezMethod loadMethod asfarrayMethod clipMethod arrayMethod array_equivMethod array_equalMethod frombufferMethod set_string_functionMethod matmulMethod genfromtxtMethod fromfunctionMethod asscalarMethod searchsortedMethod full_likeMethod fullMethod shares_memoryMethod ptpMethod digitizeMethod argwhereMethod geomspaceMethod zeros_likeMethod fabsMethod flatnonzeroMethod vstackMethod dstackMethod fromstringMethod tobytesMethod expand_dimsMethod ranfMethod arctanMethod itemMethod extractMethod compressMethod chooseMethod asarrayMethod asmatrixMethod allcloseMethod iscloseMethod anyMethod corrcoefMethod truncMethod prodMethod crossMethod true_divideMethod hsplitMethod splitMethod rintMethod ediff1dMethod lcmMethod gcdMethod cbrtMethod flipudProperty ndimMethod array2stringMethod set_printoptionsMethod whereMethod hstackChar32 topics
check_circle
Mark as learned thumb_up
0
thumb_down
0
chat_bubble_outline
0
Comment auto_stories Bi-column layout
settings
NumPy | triu Method
schedule Aug 12, 2023
Last updated local_offer
Tags Python●NumPy
tocTable of Contents
expand_more Master the mathematics behind data science with 100+ top-tier guides
Start your free 7-days trial now!
Start your free 7-days trial now!
Numpy's triu(~) method returns the upper triangle of a matrix as a new Numpy array.
Parameters
1. a | array_like
The array from which to extract the upper triangle.
2. klink | number | optional
The number of diagonals to exclude or include.
A positive value for k represents exclusion. k=1 means that the main diagonal is excluded. k=2 means that the main diagonal and the diagonal on top are excluded.
A negative value for k represents inclusion. k=-1 means that we include an additional diagonal below the main diagonal.
By default, k=0, which means that a perfect upper triangle is returned.
Return value
A new Numpy array containing the upper triangle of the provided input array.
Like almost all arrays returned Numpy's methods, the returned array of triu(~) is copied, that is, modifying this returned array will not have an impact on the original input array - the original input array is left intact.
Examples
Basic usage
To get the upper triangle as a new Numpy array:
x = np.array([[1, 2, 3], [4 ,5, 6], [7, 8, 9]])np.triu(x)
array([[1, 2, 3], [0, 5, 6], [0, 0, 9]])
Specifying a positive k
To exclude the main diagonal by setting k=1:
x = np.array([[1, 2, 3], [4 ,5, 6], [7, 8, 9]])np.triu(x, k=1)
array([[0, 2, 3], [0, 0, 6], [0, 0, 0]])
To exclude the next diagonal as well, set k=2:
x = np.array([[1, 2, 3], [4 ,5, 6], [7, 8, 9]])np.triu(x, k=2)
array([[0, 0, 3], [0, 0, 0], [0, 0, 0]])
Specifying a negative k
To include an additional diagonal, set k=-1:
x = np.array([[1, 2, 3], [4 ,5, 6], [7, 8, 9]])np.triu(x, k=-1)
array([[1, 2, 3], [4, 5, 6], [0, 8, 9]])
Published by Isshin Inada
Edited by 0 others
Did you find this page useful?
thumb_up
thumb_down
Comment
Citation
Ask a question or leave a feedback...
thumb_up
0
thumb_down
0
chat_bubble_outline
0
settings
Enjoy our search
Hit / to insta-search docs and recipes!
