ricet8ur преди 2 години
родител
ревизия
dc137c8143
променени са 4 файла, в които са добавени 40 реда и са изтрити 11 реда
  1. 39 10
      README.md
  2. BIN
      resource/repository/readme_img1.png
  3. BIN
      resource/repository/readme_img2.png
  4. 1 1
      source/frontend/info.md

+ 39 - 10
README.md

@@ -1,15 +1,44 @@
-#Вычисление добротности и ее случайной погрешности с помощью автоматического векторного сетевого анализатора
+# Вычисление добротности и ее случайной погрешности с помощью автоматического векторного сетевого анализатора
 
-Данная программа принимает файл с измерениями сетевого анализатора в формате csv с возможностью выбора разделителя,
-среди которых мы указали " ", "," и ";". Из данных, загруженных пользователем, программа вычисляет добротность
-нагруженного (Q_l) и ненагруженного (Q_0) резонаторов. К самому значению прилагаются оцененная случайная погрешность,
-и относительная случайная погрешность. Кроме того программа строит диаграмму Смита и график зависимости модуля
-коэффициента отражения от частоты для наглядности. 
+## Описание
 
-Диаграмма Смита представляет собой математическое преобразование двумерной декартовой комплексной плоскости. 
-Комплексные числа с положительными вещественными частями отображаются внутри круга. Те, у кого отрицательные 
-вещественные части, отображаются за пределами круга. Если мы имеем дело только с импедансами с неотрицательными 
-резистивными компонентами, наш интерес сосредоточен на области внутри круга.
+Программа помогает вычислять добротность и её случайную погрешность в электрической цепи по измерениям векторного анализатора.
+
+Программа принимает на вход файл с измерениями сетевого анализатора в формате .snp или csv.
+По этому файлу вычисляется добротность нагруженного (Q_l) и ненагруженного (Q_0) резонатора.
+Для этих величин также вычисляется случайная погрешность.
+Кроме того строится диаграмма Смита и график зависимости модуля коэффициента отражения от частоты.
+
+Диаграмма Смита представляет собой математическое преобразование двумерной декартовой комплексной плоскости.
+Она помогает удобно представить поведение резонатора при изменении частоты сигнала.
+
+Интерфейс программы:
+
+![Program interface1](./resource/repository/readme_img1.png?raw=true)
+![Program interface2](./resource/repository/readme_img2.png?raw=true)
 
 Запуск:
 streamlit run source/main.py
+
+## Usage
+
+App calculates the quality factor and its random error in the electric circuit
+for the set of [vector analyzer](https://en.wikipedia.org/wiki/Network_analyzer_(electrical)) measuremets.
+
+How to start:
+streamlit run source/main.py
+
+## Input data
+
+The measurements made by a vector network analyzer (set of frequencies and corresponding network parameters).
+Main supported file format is .snp, but similar formats are accepted too. Noise data is not supported.
+
+* Supported network parameters: S, Z
+* Supported parameters representations:
+real and imaginary; magnitude and angle; db and angle
+
+## Result
+
+* Loaded and unloaded quality factor (q-factor) with random errors
+* plot amplitude vs frequency
+* [Smith chart](https://en.wikipedia.org/wiki/Smith_chart)

BIN
resource/repository/readme_img1.png


BIN
resource/repository/readme_img2.png


+ 1 - 1
source/frontend/info.md

@@ -1,7 +1,7 @@
 ##### Usage:
 
 App calculates the quality factor and its random error in the electric circuit
-according to the measurements of the [vector analyzer](https://en.wikipedia.org/wiki/Network_analyzer_(electrical)).
+for the set of [vector analyzer](https://en.wikipedia.org/wiki/Network_analyzer_(electrical)) measuremets.
 
 ##### Input data