Spaces:
Sleeping
Sleeping
File size: 10,236 Bytes
e743fc5 9160077 e743fc5 9160077 e743fc5 9160077 e743fc5 9160077 e743fc5 9160077 e743fc5 9160077 e743fc5 2f6976b e743fc5 9160077 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 | # instructions.py
from dash import html, dcc
def build_instructions_layout() -> html.Div:
"""
~1-page Quick Start Guide layout for the Extraction Condition Comparison Tool.
Intended audience: analytical chemists & toxicologists.
"""
page_style = {
"fontFamily": "Arial, Helvetica, sans-serif",
"padding": "20px",
}
card_style = {
"maxWidth": "950px",
"margin": "0 auto",
"padding": "18px 22px",
"border": "1px solid #e5e5e5",
"borderRadius": "8px",
"boxShadow": "0 1px 4px rgba(0,0,0,0.06)",
"backgroundColor": "white",
"lineHeight": "1.45",
}
h1_style = {"margin": "0 0 10px 0", "fontSize": "28px"}
h2_style = {"margin": "18px 0 8px 0", "fontSize": "18px"}
p_style = {"margin": "8px 0", "color": "#333"}
small_style = {"margin": "6px 0", "color": "#555", "fontSize": "13px"}
ul_style = {"margin": "8px 0 8px 22px"}
li_style = {"marginBottom": "6px"}
callout_style = {
"marginTop": "10px",
"padding": "10px 12px",
"borderLeft": "4px solid #999",
"backgroundColor": "#fafafa",
"color": "#333",
"fontSize": "13.5px",
}
return html.Div(
style=page_style,
children=[
html.Div(
style=card_style,
children=[
html.H1("Quick Start Guide", style=h1_style),
html.P(
"Use this tool to compare predicted fractional release of boundary chemicals from a polymer "
"under two scenarios (Condition #1 vs Condition #2).",
style=p_style,
),
html.P(
["Return to the tool: ", dcc.Link("Main page", href="/")],
style=small_style,
),
html.H2("1) Choose polymer properties", style=h2_style),
html.P(
"Start in the “Polymer component” section. These inputs define the material and geometry used "
"in the transport calculations.",
style=p_style,
),
html.Ul(
style=ul_style,
children=[
html.Li([html.B("Matrix: "), "Select the polymer type (e.g., PP)."], style=li_style),
html.Li(
[
html.B("Tg (°C), Crystallinity (%), Density (g/cm³): "),
"Enter polymer properties (use best-available values; defaults are acceptable for screening).",
],
style=li_style,
),
html.Li(
[
html.B("Volume (cm³) and Surface area (cm²): "),
"Define the polymer amount and exposed area for the scenario being evaluated.",
],
style=li_style,
),
],
),
html.H2("2) Define Condition #1 and Condition #2", style=h2_style),
html.P(
"Each condition can represent either an extraction experiment (in vitro) or an in vivo exposure case.",
style=p_style,
),
html.Ul(
style=ul_style,
children=[
html.Li(
[
html.B("In vitro: "),
"Enables solvent and extraction settings (solvent, solvent volume, swelling ratio = final mass divided by initial mass, "
"extraction temperature, iterations). Use this to mimic or design extraction conditions.",
],
style=li_style,
),
html.Li(
[
html.B("In vivo (conservative): "),
"Screening-level release assumption (often higher predicted release).",
],
style=li_style,
),
html.Li(
[
html.B("In vivo (tissue): "),
"Accounts for tissue-limited behavior for a more constrained release estimate.",
],
style=li_style,
),
],
),
html.P(
"For all modes, set “Extraction time (h)” to match the scenario duration of interest.",
style=small_style,
),
html.H2("3) Monte Carlo samples", style=h2_style),
html.P(
"Set the number of samples under “Monte Carlo → Samples” (the default is typically fine).",
style=p_style,
),
html.Ul(
style=ul_style,
children=[
html.Li([html.B("500–2000"), " for routine comparisons"], style=li_style),
html.Li([html.B(">5000"), " for more stable uncertainty bounds (slower)"], style=li_style),
],
),
html.H2("4) Run and interpret results", style=h2_style),
html.P(
["Click ", html.B("Calculate"), ". The chart compares predicted fractional release by chemical (CASRN)."],
style=p_style,
),
html.Ul(
style=ul_style,
children=[
html.Li([html.B("Red bars: "), "Condition 1"], style=li_style),
html.Li([html.B("Blue bars: "), "Condition 2"], style=li_style),
html.Li(
[
html.B("Error bars: "),
"uncertainty bounds (interquartile range). Larger error bars indicate greater uncertainty.",
],
style=li_style,
),
html.Li(
[
html.B("Log-scale y-axis: "),
"equal vertical steps represent orders of magnitude differences.",
],
style=li_style,
),
],
),
# --- Revised section (replaces any convex-hull language) ---
html.Div(
style=callout_style,
children=[
html.B("How to interpret the chemical list"),
html.Br(),
"The CASRNs shown are a representative boundary set selected to span the range of molecular "
"weight and hydrophobicity (logP) expected in a chemical characterization study. "
"Because this set covers the anticipated chemical space, tool-supported conclusions "
"(e.g., which condition is more/less conservative) are intended to be applicable broadly to "
"chemicals expected in that study context.",
],
),
html.H2("Common tips & troubleshooting", style=h2_style),
html.Ul(
style=ul_style,
children=[
html.Li(
"For test articles with multiple components comprised of different polymers, the "
"tool should be run separately for each component.",
style=li_style,
),
html.Li(
"If in vitro fields appear disabled, ensure the condition mode is set to “In vitro”.",
style=li_style,
),
html.Li(
"If results look unexpected, double-check units (cm³, cm², °C, hours) and polymer geometry inputs.",
style=li_style,
),
html.Li(
"For screening, focus on relative differences between Condition 1 and 2 rather than absolute values.",
style=li_style,
),
html.Li(
"If you need a defensible justification, document the polymer geometry, exposure duration, and "
"the rationale for choosing in vitro vs in vivo modes.",
style=li_style,
),
],
),
html.Hr(style={"margin": "16px 0"}),
html.P(
"Note: Outputs are model-based predictions intended to support comparisons and study design. "
"Interpret results alongside analytical data, scenario context, and uncertainty considerations.",
style=small_style,
),
],
)
],
) |