#37798

Committed 05 Jun 2024 07:57AM UTC coverage: 83.152% (-3.8%) from 86.908%

Build # #37798

Build Type

push

local

Committed by

web-flow

Commit Message

Use the public `wait()` in the `errormonitor()` docstring (#54650)

Run Details

72847 of 87607 relevant lines covered (83.15%)

14515294.14 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

74.6

/base/arraymath.jl

# This file is a part of Julia. License is MIT: https://julialang.org/license

## Binary arithmetic operators ##

for f in (:+, :-)
    @eval function ($f)(A::AbstractArray, B::AbstractArray)
        promote_shape(A, B) # check size compatibility
        broadcast_preserving_zero_d($f, A, B)
    end
end

function +(A::Array, Bs::Array...)
    for B in Bs
        promote_shape(A, B) # check size compatibility
    end
    broadcast_preserving_zero_d(+, A, Bs...)
end

for f in (:/, :\, :*)
    if f !== :/
        @eval ($f)(A::Number, B::AbstractArray) = broadcast_preserving_zero_d($f, A, B)
    end
    if f !== :\
        @eval ($f)(A::AbstractArray, B::Number) = broadcast_preserving_zero_d($f, A, B)
    end
end

## data movement ##

"""
    reverse(A; dims=:)

Reverse `A` along dimension `dims`, which can be an integer (a
single dimension), a tuple of integers (a tuple of dimensions)
or `:` (reverse along all the dimensions, the default).  See
also [`reverse!`](@ref) for in-place reversal.

# Examples
```jldoctest
julia> b = Int64[1 2; 3 4]
2×2 Matrix{Int64}:
 1  2
 3  4

julia> reverse(b, dims=2)
2×2 Matrix{Int64}:
 2  1
 4  3

julia> reverse(b)
2×2 Matrix{Int64}:
 4  3
 2  1
```

!!! compat "Julia 1.6"
    Prior to Julia 1.6, only single-integer `dims` are supported in `reverse`.
"""
reverse(A::AbstractArray; dims=:) = _reverse(A, dims)
_reverse(A, dims) = reverse!(copymutable(A); dims)

"""
    reverse!(A; dims=:)

Like [`reverse`](@ref), but operates in-place in `A`.

!!! compat "Julia 1.6"
    Multidimensional `reverse!` requires Julia 1.6.
"""
reverse!(A::AbstractArray; dims=:) = _reverse!(A, dims)
_reverse!(A::AbstractArray{<:Any,N}, ::Colon) where {N} = _reverse!(A, ntuple(identity, Val{N}()))
_reverse!(A, dim::Integer) = _reverse!(A, (Int(dim),))
_reverse!(A, dims::NTuple{M,Integer}) where {M} = _reverse!(A, Int.(dims))
function _reverse!(A::AbstractArray{<:Any,N}, dims::NTuple{M,Int}) where {N,M}
    dimrev = ntuple(k -> k in dims, Val{N}()) # boolean tuple indicating reversed dims

    if N < M || M != sum(dimrev)
        throw(ArgumentError("invalid dimensions $dims in reverse!"))
    end
    M == 0 && return A # nothing to reverse

    # swapping loop only needs to traverse ≈half of the array
    halfsz = ntuple(k -> k == dims[1] ? size(A,k) ÷ 2 : size(A,k), Val{N}())

    last1 = ntuple(k -> lastindex(A,k)+firstindex(A,k), Val{N}()) # offset for reversed index
    for i in CartesianIndices(ntuple(k -> firstindex(A,k):firstindex(A,k)-1+@inbounds(halfsz[k]), Val{N}()))
        iₜ = Tuple(i)
        iᵣ = CartesianIndex(ifelse.(dimrev, last1 .- iₜ, iₜ))
        @inbounds A[iᵣ], A[i] = A[i], A[iᵣ]
    end
    if M > 1 && isodd(size(A, dims[1]))
        # middle slice for odd dimensions must be recursively flipped
        mid = firstindex(A, dims[1]) + (size(A, dims[1]) ÷ 2)
        midslice = CartesianIndices(ntuple(k -> k == dims[1] ? (mid:mid) : (firstindex(A,k):lastindex(A,k)), Val{N}()))
        _reverse!(view(A, midslice), dims[2:end])
    end
    return A
end
# fix ambiguity with array.jl:
_reverse!(A::AbstractVector, dim::Tuple{Int}) = _reverse!(A, first(dim))


"""
    rotl90(A)

Rotate matrix `A` left 90 degrees.

# Examples
```jldoctest
julia> a = [1 2; 3 4]
2×2 Matrix{Int64}:
 1  2
 3  4

julia> rotl90(a)
2×2 Matrix{Int64}:
 2  4
 1  3
```
"""
function rotl90(A::AbstractMatrix)
    ind1, ind2 = axes(A)
    B = similar(A, (ind2,ind1))
    n = first(ind2)+last(ind2)
    for i=axes(A,1), j=ind2
        B[n-j,i] = A[i,j]
    end
    return B
end

"""
    rotr90(A)

Rotate matrix `A` right 90 degrees.

# Examples
```jldoctest
julia> a = [1 2; 3 4]
2×2 Matrix{Int64}:
 1  2
 3  4

julia> rotr90(a)
2×2 Matrix{Int64}:
 3  1
 4  2
```
"""
function rotr90(A::AbstractMatrix)
    ind1, ind2 = axes(A)
    B = similar(A, (ind2,ind1))
    m = first(ind1)+last(ind1)
    for i=ind1, j=axes(A,2)
        B[j,m-i] = A[i,j]
    end
    return B
end
"""
    rot180(A)

Rotate matrix `A` 180 degrees.

# Examples
```jldoctest
julia> a = [1 2; 3 4]
2×2 Matrix{Int64}:
 1  2
 3  4

julia> rot180(a)
2×2 Matrix{Int64}:
 4  3
 2  1
```
"""
function rot180(A::AbstractMatrix)
    B = similar(A)
    ind1, ind2 = axes(A,1), axes(A,2)
    m, n = first(ind1)+last(ind1), first(ind2)+last(ind2)
    for j=ind2, i=ind1
        B[m-i,n-j] = A[i,j]
    end
    return B
end
"""
    rotl90(A, k)

Left-rotate matrix `A` 90 degrees counterclockwise an integer `k` number of times.
If `k` is a multiple of four (including zero), this is equivalent to a `copy`.

# Examples
```jldoctest
julia> a = [1 2; 3 4]
2×2 Matrix{Int64}:
 1  2
 3  4

julia> rotl90(a,1)
2×2 Matrix{Int64}:
 2  4
 1  3

julia> rotl90(a,2)
2×2 Matrix{Int64}:
 4  3
 2  1

julia> rotl90(a,3)
2×2 Matrix{Int64}:
 3  1
 4  2

julia> rotl90(a,4)
2×2 Matrix{Int64}:
 1  2
 3  4
```
"""
function rotl90(A::AbstractMatrix, k::Integer)
    k = mod(k, 4)
    k == 1 ? rotl90(A) :
    k == 2 ? rot180(A) :
    k == 3 ? rotr90(A) : copy(A)
end
"""
    rotr90(A, k)

Right-rotate matrix `A` 90 degrees clockwise an integer `k` number of times.
If `k` is a multiple of four (including zero), this is equivalent to a `copy`.

# Examples
```jldoctest
julia> a = [1 2; 3 4]
2×2 Matrix{Int64}:
 1  2
 3  4

julia> rotr90(a,1)
2×2 Matrix{Int64}:
 3  1
 4  2

julia> rotr90(a,2)
2×2 Matrix{Int64}:
 4  3
 2  1

julia> rotr90(a,3)
2×2 Matrix{Int64}:
 2  4
 1  3

julia> rotr90(a,4)
2×2 Matrix{Int64}:
 1  2
 3  4
```
"""
rotr90(A::AbstractMatrix, k::Integer) = rotl90(A,-k)
"""
    rot180(A, k)

Rotate matrix `A` 180 degrees an integer `k` number of times.
If `k` is even, this is equivalent to a `copy`.

# Examples
```jldoctest
julia> a = [1 2; 3 4]
2×2 Matrix{Int64}:
 1  2
 3  4

julia> rot180(a,1)
2×2 Matrix{Int64}:
 4  3
 2  1

julia> rot180(a,2)
2×2 Matrix{Int64}:
 1  2
 3  4
```
"""
rot180(A::AbstractMatrix, k::Integer) = mod(k, 2) == 1 ? rot180(A) : copy(A)

1	# This file is a part of Julia. License is MIT: https://julialang.org/license
2
3	## Binary arithmetic operators ##
4
5	for f in (:+, :-)
6	@eval function ($f)(A::AbstractArray, B::AbstractArray)	121,421✔
7	promote_shape(A, B) # check size compatibility	231,778✔
8	broadcast_preserving_zero_d($f, A, B)	124,178✔
9	end
10	end
11
12	function +(A::Array, Bs::Array...)	7,935✔
13	for B in Bs	7,935✔
14	promote_shape(A, B) # check size compatibility	11,986✔
15	end	7,929✔
16	broadcast_preserving_zero_d(+, A, Bs...)	7,930✔
17	end
18
19	for f in (:/, :\, :*)
20	if f !== :/
21	@eval ($f)(A::Number, B::AbstractArray) = broadcast_preserving_zero_d($f, A, B)	8,392✔
22	end
23	if f !== :\
24	@eval ($f)(A::AbstractArray, B::Number) = broadcast_preserving_zero_d($f, A, B)	3,380✔
25	end
26	end
27
28	## data movement ##
29
30	"""
31	reverse(A; dims=:)
32
33	Reverse `A` along dimension `dims`, which can be an integer (a
34	single dimension), a tuple of integers (a tuple of dimensions)
35	or `:` (reverse along all the dimensions, the default). See
36	also [`reverse!`](@ref) for in-place reversal.
37
38	# Examples
39	```jldoctest
40	julia> b = Int64[1 2; 3 4]
41	2×2 Matrix{Int64}:
42	1 2
43	3 4
44
45	julia> reverse(b, dims=2)
46	2×2 Matrix{Int64}:
47	2 1
48	4 3
49
50	julia> reverse(b)
51	2×2 Matrix{Int64}:
52	4 3
53	2 1
54	```
55
56	!!! compat "Julia 1.6"
57	Prior to Julia 1.6, only single-integer `dims` are supported in `reverse`.
58	"""
59	reverse(A::AbstractArray; dims=:) = _reverse(A, dims)	288✔
60	_reverse(A, dims) = reverse!(copymutable(A); dims)	91✔
61
62	"""
63	reverse!(A; dims=:)
64
65	Like [`reverse`](@ref), but operates in-place in `A`.
66
67	!!! compat "Julia 1.6"
68	Multidimensional `reverse!` requires Julia 1.6.
69	"""
70	reverse!(A::AbstractArray; dims=:) = _reverse!(A, dims)	272✔
71	_reverse!(A::AbstractArray{<:Any,N}, ::Colon) where {N} = _reverse!(A, ntuple(identity, Val{N}()))	28✔
72	_reverse!(A, dim::Integer) = _reverse!(A, (Int(dim),))	89✔
73	_reverse!(A, dims::NTuple{M,Integer}) where {M} = _reverse!(A, Int.(dims))	×
74	function _reverse!(A::AbstractArray{<:Any,N}, dims::NTuple{M,Int}) where {N,M}	139✔
75	dimrev = ntuple(k -> k in dims, Val{N}()) # boolean tuple indicating reversed dims	432✔
76
77	if N < M \|\| M != sum(dimrev)	139✔
78	throw(ArgumentError("invalid dimensions $dims in reverse!"))	×
79	end
80	M == 0 && return A # nothing to reverse	139✔
81
82	# swapping loop only needs to traverse ≈half of the array
83	halfsz = ntuple(k -> k == dims[1] ? size(A,k) ÷ 2 : size(A,k), Val{N}())	589✔
84
85	last1 = ntuple(k -> lastindex(A,k)+firstindex(A,k), Val{N}()) # offset for reversed index	417✔
86	for i in CartesianIndices(ntuple(k -> firstindex(A,k):firstindex(A,k)-1+@inbounds(halfsz[k]), Val{N}()))	555✔
87	iₜ = Tuple(i)	5,133✔
88	iᵣ = CartesianIndex(ifelse.(dimrev, last1 .- iₜ, iₜ))	5,133✔
89	@inbounds A[iᵣ], A[i] = A[i], A[iᵣ]	5,133✔
90	end	5,271✔
91	if M > 1 && isodd(size(A, dims[1]))	169✔
92	# middle slice for odd dimensions must be recursively flipped
93	mid = firstindex(A, dims[1]) + (size(A, dims[1]) ÷ 2)	35✔
94	midslice = CartesianIndices(ntuple(k -> k == dims[1] ? (mid:mid) : (firstindex(A,k):lastindex(A,k)), Val{N}()))	54✔
95	_reverse!(view(A, midslice), dims[2:end])	18✔
96	end
97	return A	139✔
98	end
99	# fix ambiguity with array.jl:
100	_reverse!(A::AbstractVector, dim::Tuple{Int}) = _reverse!(A, first(dim))	×
101
102
103	"""
104	rotl90(A)
105
106	Rotate matrix `A` left 90 degrees.
107
108	# Examples
109	```jldoctest
110	julia> a = [1 2; 3 4]
111	2×2 Matrix{Int64}:
112	1 2
113	3 4
114
115	julia> rotl90(a)
116	2×2 Matrix{Int64}:
117	2 4
118	1 3
119	```
120	"""
121	function rotl90(A::AbstractMatrix)	2✔
122	ind1, ind2 = axes(A)	2✔
123	B = similar(A, (ind2,ind1))	4✔
124	n = first(ind2)+last(ind2)	2✔
125	for i=axes(A,1), j=ind2	2✔
126	B[n-j,i] = A[i,j]	32✔
127	end	38✔
128	return B	2✔
129	end
130
131	"""
132	rotr90(A)
133
134	Rotate matrix `A` right 90 degrees.
135
136	# Examples
137	```jldoctest
138	julia> a = [1 2; 3 4]
139	2×2 Matrix{Int64}:
140	1 2
141	3 4
142
143	julia> rotr90(a)
144	2×2 Matrix{Int64}:
145	3 1
146	4 2
147	```
148	"""
149	function rotr90(A::AbstractMatrix)	2✔
150	ind1, ind2 = axes(A)	2✔
151	B = similar(A, (ind2,ind1))	4✔
152	m = first(ind1)+last(ind1)	2✔
153	for i=ind1, j=axes(A,2)	2✔
154	B[j,m-i] = A[i,j]	32✔
155	end	38✔
156	return B	2✔
157	end
158	"""
159	rot180(A)
160
161	Rotate matrix `A` 180 degrees.
162
163	# Examples
164	```jldoctest
165	julia> a = [1 2; 3 4]
166	2×2 Matrix{Int64}:
167	1 2
168	3 4
169
170	julia> rot180(a)
171	2×2 Matrix{Int64}:
172	4 3
173	2 1
174	```
175	"""
176	function rot180(A::AbstractMatrix)	×
177	B = similar(A)	×
178	ind1, ind2 = axes(A,1), axes(A,2)	×
179	m, n = first(ind1)+last(ind1), first(ind2)+last(ind2)	×
180	for j=ind2, i=ind1	×
181	B[m-i,n-j] = A[i,j]	×
182	end	×
183	return B	×
184	end
185	"""
186	rotl90(A, k)
187
188	Left-rotate matrix `A` 90 degrees counterclockwise an integer `k` number of times.
189	If `k` is a multiple of four (including zero), this is equivalent to a `copy`.
190
191	# Examples
192	```jldoctest
193	julia> a = [1 2; 3 4]
194	2×2 Matrix{Int64}:
195	1 2
196	3 4
197
198	julia> rotl90(a,1)
199	2×2 Matrix{Int64}:
200	2 4
201	1 3
202
203	julia> rotl90(a,2)
204	2×2 Matrix{Int64}:
205	4 3
206	2 1
207
208	julia> rotl90(a,3)
209	2×2 Matrix{Int64}:
210	3 1
211	4 2
212
213	julia> rotl90(a,4)
214	2×2 Matrix{Int64}:
215	1 2
216	3 4
217	```
218	"""
219	function rotl90(A::AbstractMatrix, k::Integer)	×
220	k = mod(k, 4)	×
221	k == 1 ? rotl90(A) :	×
222	k == 2 ? rot180(A) :
223	k == 3 ? rotr90(A) : copy(A)
224	end
225	"""
226	rotr90(A, k)
227
228	Right-rotate matrix `A` 90 degrees clockwise an integer `k` number of times.
229	If `k` is a multiple of four (including zero), this is equivalent to a `copy`.
230
231	# Examples
232	```jldoctest
233	julia> a = [1 2; 3 4]
234	2×2 Matrix{Int64}:
235	1 2
236	3 4
237
238	julia> rotr90(a,1)
239	2×2 Matrix{Int64}:
240	3 1
241	4 2
242
243	julia> rotr90(a,2)
244	2×2 Matrix{Int64}:
245	4 3
246	2 1
247
248	julia> rotr90(a,3)
249	2×2 Matrix{Int64}:
250	2 4
251	1 3
252
253	julia> rotr90(a,4)
254	2×2 Matrix{Int64}:
255	1 2
256	3 4
257	```
258	"""
259	rotr90(A::AbstractMatrix, k::Integer) = rotl90(A,-k)	×
260	"""
261	rot180(A, k)
262
263	Rotate matrix `A` 180 degrees an integer `k` number of times.
264	If `k` is even, this is equivalent to a `copy`.
265
266	# Examples
267	```jldoctest
268	julia> a = [1 2; 3 4]
269	2×2 Matrix{Int64}:
270	1 2
271	3 4
272
273	julia> rot180(a,1)
274	2×2 Matrix{Int64}:
275	4 3
276	2 1
277
278	julia> rot180(a,2)
279	2×2 Matrix{Int64}:
280	1 2
281	3 4
282	```
283	"""
284	rot180(A::AbstractMatrix, k::Integer) = mod(k, 2) == 1 ? rot180(A) : copy(A)	×

JuliaLang / julia / #37798

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous