Valis và Các Phép Tính

Vali là các tham số thiết kế của Block, Requirement hoặc Analysis, có thể được օգտագործed trong tính toán và tài liệu hóa. Một Vali có giá trị số và cũng chứa thông tin bổ sung như loại, đơn vị, công thức, mô tả và các yêu cầu min/max.

Tạo Vali

Bạn có thể tạo Vali trong một Block bằng cách trước tiên nhấp vào biểu tượng “+” ở góc dưới bên phải màn hình. Sau đó, tiếp tục điền tên (có thể là bất kỳ tên nào hoặc tên Valitype - 1), Công thức và Đơn vị (bắt buộc - 2), Đơn vị hiển thị (tùy chọn - 3), rồi nhấn “Create” hoặc “Create & add New” (xem Hình Adding a Vali). Để xem hướng dẫn về Đơn vị và cách chuyển đổi đơn vị, vui lòng tham khảo Units and Automatic Unit Conversion.

Ngoài ra, bạn có thể quyết định Block nào sẽ được thêm Vali này (4).

Pro-tip: Trong trường Công thức và Đơn vị, nhấn “\“ để nhận danh sách các kiểu tính toán có thể dùng.

Thêm Vali - Cửa sổ pop-up để thêm các loại Vali khác nhau.

Lưu ý rằng khi tạo một thuộc tính, người dùng có thể tạo các loại Vali khác nhau, ví dụ: Vali thông thường, Matrix, Text Vali, Datevali hoặc Dataset.

Type	Use-case
Vali	Thuộc tính của Block chỉ có một giá trị duy nhất, ví dụ: khối lượng, chi phí, mật độ.
Matrix	Ma trận là một nhóm các Vali riêng lẻ được sắp xếp theo hàng và cột. Matrix Vali thường được dùng khi thuộc tính của các Block có các chế độ khác nhau. Ví dụ: mức tiêu thụ điện năng ở các chế độ khác nhau, các giá trị mô men quán tính theo các trục khác nhau.
Text Vali	Một Vali lưu chuỗi/văn bản, ví dụ:
DateVali	Một Vali lưu thông tin ngày tháng, ví dụ:
Dataset	Tại đây, người dùng có thể nhập hoặc thêm các giá trị dataset, tạo đồ thị và sử dụng các giá trị đó trong việc tính toán các giá trị khác.

Thêm công thức

Một Vali có thể được tính bằng công thức sử dụng các biểu thức toán học thông dụng hoặc bằng cách thêm hằng số hay hàm. Công thức cũng có thể chứa các Vali khác.

Trong trường Công thức và Đơn vị, người dùng có thể tham chiếu các Vali có sẵn trong dự án hoặc trong các dự án khác. Để làm điều đó, họ có thể vào “Formula and Unit” và nhập “$”, một hộp thoại nhỏ sẽ mở ra với các Vali bên trong (xem Hình Calling Valis). Người dùng có thể nhập từ khóa để tìm Vali dễ hơn.

Gọi Vali - Ở bất kỳ đâu trong Requirements & Systems Portal, bạn có thể dùng ký hiệu đô la “$“ để mở một danh sách thả xuống hiển thị mọi đối tượng có thể tham chiếu (ví dụ: Vali, Requirements, v.v.).

Trong trường hợp người dùng muốn dùng Vali từ một dự án khác, họ có thể cuộn xuống cuối hộp thoại để chọn tùy chọn “show other projects”.

Các loại công thức phổ biến

Bạn có thể

• dùng một giá trị cố định, chẳng hạn như 42.7kg

• dùng một công thức, chẳng hạn như 5/(3+17.3*9)

• dùng các Vali khác, sử dụng ký hiệu $ : $car.speed+5

Các phép toán có sẵn trong công thức là:

• +, -, *, /

• %(phép modulo)

• ^

• sqrt()

• exp()

• log10(), ln(), log()

• sin(), cos(), tan()

• asin(), acos(), atan()

• sinh(), cosh(), tanh()

• fabs(): trả về giá trị tuyệt đối

• soc() = "Tổng của các phần tử con": tổng của tất cả các Vali cùng loại trong các sub Block

• poc() = "Tích của các phần tử con": tích của tất cả các Vali cùng loại trong các sub Block

Bạn cũng có thể sử dụng các hàm logic sau trong công thức:

• if(condition, formula_if_true, formula_if_false)

• max(formula1, formula2)

• min(formula1, formula2)

Các hàm tích hợp sẵn của Requirements & Systems Portal:

• soc(): là viết tắt của "sum of children", cộng tất cả các Vali cùng loại trong các Block ở cấp ngay bên dưới

• rssoc(): Là viết tắt của “root sum squared of children” sqrt(x1^2+x2^2+⋯+xn^2). Ví dụ, nếu bạn có ba khối lượng 2kg, 5kg và 6kg, hàm rssoc sẽ cho kết quả 8.062257

• aoc(): là viết tắt của "average of children", tính giá trị trung bình của các Vali cùng loại trong các Block ở cấp ngay bên dưới

• poc(): là viết tắt của "product of children", nhân tất cả các Vali cùng loại trong các Block ở cấp ngay bên dưới

• average_of_datasets() hoặc aod(): kết quả của Vali là giá trị trung bình tại từng điểm của các dataset thuộc Vali đó. Nếu chỉ có một dataset, dataset đó sẽ là kết quả và được dùng trong các phép tính tiếp theo

• sum_of_datasets() hoặc sod(): kết quả của Vali là tổng tại từng điểm của các dataset thuộc Vali đó. Nếu chỉ có một dataset, dataset đó sẽ là kết quả và được dùng trong các phép tính tiếp theo

• property($vali, property_name): Lấy một thuộc tính của Vali. Các giá trị có thể có cho property_name là:

  • min

  • max (để lấy lần lượt các yêu cầu min và max)

  • wc_minus

  • wc_plus (để lấy lần lượt các trường hợp xấu nhất âm và dương)

• minoc(): Giá trị nhỏ nhất của các phần tử con. Trả về giá trị nhỏ nhất của tất cả các Vali cùng loại trong các sub Block

• maxoc(): Giá trị lớn nhất của các phần tử con. Trả về giá trị lớn nhất của tất cả các Vali cùng loại trong các sub Block

• round(): Hàm tích hợp sẵn round( ) tuân theo đặc tả của hàm round của Python, trong đó các giá trị được làm tròn đến bội số gần nhất của 10 mũ âm ndigits

   

Ví dụ về công thức:

• $SolarPanel.width * $SolarPanel.length

• max(soc(), $SolarPanel.lowest_mass)

• if($SolarPanel.width*2 > $SolarPanel.length, 10, 5)

Vali Information

Bạn có thể xem thêm thông tin về Vali bằng cách nhấp vào tên của nó. Thao tác này sẽ mở chế độ xem chi tiết (1) và người dùng có thể tìm thấy thông tin (2). Xem Hình Vali Information để biết thêm chi tiết.

Thông tin Vali - Khi nhấp vào một Vali, một cửa sổ với thông tin bổ sung sẽ mở ra. Tại đây bạn có thể xác định thêm thuộc tính, thêm mô tả và xác định các tác động.

Trong tab thông tin, người dùng có nhiều khả năng để thêm/thay đổi margin/đơn vị và cũng có thể thêm các yêu cầu (min/max). Các yêu cầu (min/max) là các giới hạn mà bạn đặt cho thuộc tính cụ thể đó. Bất cứ khi nào giá trị hoặc worst-case tăng hoặc giảm, nếu các giá trị vượt quá hoặc thấp hơn giới hạn yêu cầu, Requirements & Systems Portal sẽ hiển thị cảnh báo bên cạnh tên của Vali. Hãy tham khảo phần Warnings để biết thêm thông tin.

Lưu ý rằng total margin được hiển thị trong thuộc tính của Vali là margin của Block và tổng margin tích lũy của các child Block. Để biết thêm thông tin về Margin, vui lòng truy cập trang trợ giúp của chúng tôi về Margins.

ID: ID là một số được tạo ngẫu nhiên và tự động thêm bởi Valiengine, được sử dụng ở Backend. Bạn có thể nhập ID của một Vali vào trường tìm kiếm của Rest API để tìm Vali đó. Vui lòng tham khảo tài liệu Rest API.

Name: tại đây bạn có thể nhập và chỉnh sửa tên của Vali.

Description: trong trường mô tả, bạn có thể nhập mô tả cho Vali. Bạn cũng có thể định dạng và chỉnh sửa tác vụ như minh họa bên dưới.

Các thông tin khác có thể được thêm/xem tại đây bao gồm References, Using và Used by, cũng như Impacts của Vali này.

Lịch sử của Vali

Khi một Vali được thay đổi trực tiếp hoặc gián tiếp, các thay đổi sẽ tự động được lưu trong cơ sở dữ liệu của Requirements & Systems Portal. Tab lịch sử của Vali hiển thị giá trị trước đó, giá trị sau đó và ai đã thay đổi các giá trị. Requirements & Systems Portal ghi lại các thay đổi ngay cả khi Vali bị thay đổi không được tham chiếu trực tiếp đến Vali đó.

Để xem lịch sử thay đổi của một Vali (xem Hình Vali History), hãy nhấp vào tên của Vali (1) và tab chi tiết sẽ mở ra (2). Chọn biểu tượng “History” (2) và bên dưới, bạn sẽ thấy biểu đồ thể hiện các thay đổi theo thời gian. Trong “Recent Changes” (3) người dùng có thể thấy một bảng chứa dữ liệu ‘Time’, ‘Value before’, ‘Value after’ và ‘Reason’.

Lịch sử Vali - Trong tab History, thay đổi của một Vali theo thời gian được hiển thị dưới dạng đồ họa và bảng.

Thông báo khi có thay đổi

Để nhận thông báo khi một Vali cụ thể thay đổi, bạn có thể đăng ký theo dõi bằng cách nhấp vào Subscribe trong menu thả xuống của nút Action của Vali. Hãy xem Hình Subscribing to a Vali để biết cách thực hiện.

Đăng ký theo dõi một Vali - Khi đăng ký theo dõi một Vali, thông báo tự động sẽ được hiển thị trong tab Notification (biểu tượng chuông ở góc trên bên phải) khi Vali thay đổi.

Bạn sẽ thấy một thông báo mới trên chuông thông báo ở góc trên bên phải khi có ai đó thay đổi một giá trị mà bạn đã đăng ký theo dõi (4). Sau đó, bạn có thể nhấp vào biểu tượng chuông để kiểm tra các thông báo.