Switch to unified view

a b/docs/talk2biomodels/faq.md
1
### T2B - Frequently Asked Questions (FAQs)
2
3
#### 1. How can I find models related to a specific disease or topic?
4
<details>
5
  <summary>Click to expand</summary>
6
  You can use the `Search_models` tool to query the BioModels database for relevant models based on keywords. Here are some examples:
7
  <br>
8
  - Search for Crohn’s disease models:
9
    ```
10
    Search models on Crohn’s disease
11
    ```
12
  - Find models on COVID-19:
13
    ```
14
    Find models on COVID-19
15
    ```
16
</details>
17
18
#### 2. How can I get details about a specific model?
19
<details>
20
  <summary>Click to expand</summary>
21
  Use the `Get_modelinfo` tool to retrieve information such as species names, parameters, initial values, and descriptions. Examples:
22
  <br>
23
  - Briefly describe a model:
24
    ```
25
    Briefly describe model 971
26
    ```
27
  - List all species and parameters in a model:
28
    ```
29
    List all the species and parameters in model 971
30
    ```
31
  - Get the initial concentration of a specific species:
32
    ```
33
    What is the initial concentration of Pyruvate in model 64?
34
    ```
35
  - List model name and units in a table format:
36
    ```
37
    List the name and units in model 537. Show them as a table.
38
    ```
39
</details>
40
41
#### 3. How do I retrieve annotations from a model?
42
<details>
43
  <summary>Click to expand</summary>
44
  The `Get_annotations` tool extracts model annotations and provides descriptions from UniProt and OLS databases where possible.
45
  <br>
46
  - Show all annotations in a model:
47
    ```
48
    Show me all the annotations in model 64
49
    ```
50
  - Retrieve specific annotations related to interleukins:
51
    ```
52
    Show me annotations of only interleukin-related species in model 537
53
    ```
54
</details>
55
56
#### 4. How do I run a simulation on a model?
57
<details>
58
  <summary>Click to expand</summary>
59
  Use the `Simulate_model` tool to simulate a model. You can specify duration, time intervals, and initial values for species/parameters.
60
  <br>
61
  - Basic simulation:
62
    ```
63
    Simulate model 64
64
    ```
65
  - Specify simulation time and interval:
66
    ```
67
    Simulate model 64 for 3 days with an interval of 10
68
    ```
69
  - Set initial concentration and add recurring events:
70
    ```
71
    Run a simulation on model 537 for 100 hours with a time interval of 50.
72
    Set the initial concentration of Ab{serum} to 100.
73
    Add a recurring event that resets Ab{serum} to 100 every 20 hours.
74
    ```
75
</details>
76
77
#### 5. Can I create custom plots from my simulation results?
78
<details>
79
  <summary>Click to expand</summary>
80
  The `Custom_plotter` tool helps you focus on a subset of species in a simulation plot.
81
  <br>
82
  - Plot only CRP-related species:
83
    ```
84
    Make a custom plot to show only CRP-related species.
85
    ```
86
  - Plot glucose-related species:
87
    ```
88
    Plot only glucose-related species.
89
    ```
90
</details>
91
92
#### 6. How do I bring a model to steady state?
93
<details>
94
  <summary>Click to expand</summary>
95
  The `Steady_state` tool helps stabilize a model.
96
  <br>
97
  - Basic steady-state analysis:
98
    ```
99
    Bring model 64 to a steady state
100
    ```
101
  - Set initial conditions before analysis:
102
    ```
103
    Bring model 64 to a steady state. Set the initial concentration of Pyruvate to 50.
104
    ```
105
</details>
106
107
#### 7. How do I ask questions about the simulation results?
108
<details>
109
  <summary>Click to expand</summary>
110
  Use the `Ask_question` tool after running a simulation or steady-state analysis to retrieve insights.
111
  <br>
112
  - Steady-state concentration of a species:
113
    ```
114
    What is the steady-state concentration of Pyruvate?
115
    ```
116
  - Time required for a species to reach steady state:
117
    ```
118
    How long does glucose-related species take to reach steady state?
119
    ```
120
  - Final concentration in a simulation:
121
    ```
122
    What is the concentration of CRP-related species at the end of the simulation?
123
    ```
124
</details>
125
126
#### 8. How do I analyze how one species or parameter affects another?
127
<details>
128
  <summary>Click to expand</summary>
129
  The `Parameter_scan` tool allows you to analyze how changes in one parameter affect another.
130
  <br>
131
  - Effect of extracellular glucose on Pyruvate:
132
    ```
133
    How does the value of Pyruvate change in model 64 if the concentration of Extracellular Glucose is changed from 10 to 100 with a step size of 10? The simulation should run for 5 time units with an interval of 10.
134
    ```
135
  - Effect of dose changes on CRP concentration:
136
    ```
137
    Run a param scan in model 537 to observe change in concentration of CRP in serum over time if initial value of the parameter Dose is changed from 100 to 500 with a step size of 25.
138
    ```
139
</details>
140
141
#### 9. Can I ask questions about a research article I uploaded?
142
<details>
143
  <summary>Click to expand</summary>
144
  The `Query_article` tool helps analyze uploaded research articles.
145
  <br>
146
  - Summarize key takeaways:
147
    ```
148
    What are the key takeaways of the uploaded article?
149
    ```
150
  - Find parameter descriptions in the article:
151
    ```
152
    Query the uploaded article to suggest possible description of the parameter gR in model 64.
153
    ```
154
</details>
155
156
#### 10. How can I compare different simulations or steady-state results?
157
<details>
158
  <summary>Click to expand</summary>
159
  Assign names to different experiments and compare results.
160
  <br>
161
  - Compare simulations:
162
    ```
163
    Simulate model 537 for 2016 hours. Call it experiment Treatment4wk.
164
    ```
165
    ```
166
    Redo the simulation for 2016 hours but set the initial value of Dose to 0 and DoseQ2W to 300. Call it experiment Treatment2wk.
167
    ```
168
    ```
169
    What is the concentration of CRP in serum at the end of the simulation in all experiments done so far?
170
    ```
171
  - Compare steady-state results:
172
    ```
173
    Bring model 64 to a steady state. Call it Experiment_1.
174
    ```
175
    ```
176
    Bring model 64 to a steady state. Set initial concentration of NADH to 10. Call it Experiment_2.
177
    ```
178
    ```
179
    Compare the concentration of Pyruvate in both experiments at steady state.
180
    ```
181
</details>
182