o_195h4n6al16jb186b1b2qs7fgssa.pdf

which
is a vector. When the result is also a vector, this is referred to as the destination
vector.
Some operations resulting in a vector allow computation in place. This means
the
results of the operation are placed back into the source vector (or the source one
vector
for binary operations). In this case, the destination vector is said to (physically)
replace
the source (one) vector. If an operation can be computed in place, it is indicated
as such
in the comments provided with the function description.
For some binary operations, the two operands can be the same (physical) source
vector, which means the operation is applied to the source vector and itself. If
this type
of computation is possible for a given operation,it is indicated as such in the
comments
provided with the function description.
Some operations can be both self applicable and computed in place.
All the fractional vector operations in thislibrary take as an argument the
cardinality
(number of elements) of the operand vector(s). Based on the value of this
argument the
following assumptions are made:
a) The sum of sizes of all the vectors involved in a particular operation falls
within
the range of available data memory for the target device.
b) In the case of binary operations, the cardinalities of both operand vectors
must
obey the rules of vector algebra (particularly, see remarks for the
VectorConvolveand VectorCorrelatefunctions).
c) The destination vector mustbe large enough to accept the results of an
operation.
dsPIC
®
Language Tools Libraries
DS51456B-page 14
2.3.2 User Considerations
2004 Microchip Technology Inc.
a) No boundary checking is performed by these functions. Out of range
cardinalities
(including zero length vectors) as well as nonconforming use of source vector
sizes in binary operations may produce unexpected results.
b) The vector addition and subtraction operations could lead to saturation if the
sum
of corresponding elements in the source vector(s) is greater than 1-2
vi cardinalities
(Bao gồm cả không vector chiều dài) cũng như sử dụng không phù hợp của
vector nguồn
kích thước trong các hoạt động nhị phân có thể tạo ra kết quả bất ngờ.
b) Các cộng và trừ các hoạt động vector có thể dẫn đến bão hòa nếu tổng
các yếu tố tương ứng trong vector nguồn (s) lớn hơn 1-2
-15
hoặc
nhỏ hơn -1,0. Tương tự, các vector chấm sản phẩm và các hoạt động năng lượn
có thể dẫn đến bão hòa nếu tổng sản phẩm lớn hơn 1-2
-15
hoặc nhỏ hơn
hơn -1,0.
c) Đó là khuyến cáo rằng tình trạng đăng ký (SR) được xem xét sau khi hoàn
thành
mỗi lần gọi hàm. Đặc biệt, người dùng có thể kiểm tra việc SA, SB và SAB cờ
sau
hàm trả về để xác định độ bão hòa xảy ra.
d) Tất cả các chức năng đã được thiết kế để hoạt động trên các vector phân đoạn
phân bổ
trong không gian bộ nhớ RAM mặc định (X-Y-dữ liệu hoặc dữ liệu).
e) Các hoạt động đó trả về một vector đích có thể được lồng vào nhau, do đó, v
dụ
nếu:
a = OP1 (b, c), với b = OP2 (d) và c = op3 (e, f), sau đó
a = OP1 (OP2 (d), op3 (e, f))
2.3.3 Bình luận khác
Mô tả các chức năng giới hạn phạm vi của nó những gì có thể được coi là
thường xuyên
sử dụng các hoạt động này. Tuy nhiên, vì không có kiểm tra biên giới được thự
hiện trong quá trình
tính toán của các chức năng này, bạn có quyền tự do để giải thích các hoạt động
của mình và
kết quả là nó phù hợp với một số nhu cầu đặc biệt.
Ví dụ, trong khi tính toán VectorMaxfunction, chiều dài của vector nguồn
có thể là lớn hơn numElems. Trong trường hợp này, các chức năng sẽ được sử
dụng để tìm
giá trị tối đa onlyamong các numElemselements đầu tiên của vector nguồn.
Một ví dụ khác, bạn có thể quan tâm đến việc thay thế numElemselements của
một vector điểm nằm giữa Nand N + numElems-1, với numElemselements từ
một vector nguồn nằm giữa các yếu tố mand M + numElems-1. Sau đó,
VectorCopyfunction có thể được sử dụng như sau:
phân đoạn * DSTV [DST_ELEMS] = {...};
phân đoạn * srcV [SRC_ELEMS] = {...};