Update pharmacokinetic parameters/calculations, add advanced settings, add disclaimer/citations, many improvements

This commit is contained in:
2026-01-09 19:50:15 +00:00
parent abd8e790b8
commit b396caa67a
14 changed files with 2222 additions and 192 deletions

View File

@@ -43,18 +43,19 @@ export const en = {
axisLabelHours: "Hours (h)",
axisLabelTimeOfDay: "Time of Day (h)",
tickNoon: "Noon",
refLineRegularPlan: "Regular Plan",
refLineDeviatingPlan: "Deviation from Plan",
refLineNoDeviation: "No Deviation",
refLineRegularPlan: "Regular",
refLineNoDeviation: "Regular",
refLineRecovering: "Recovering",
refLineIrregularIntake: "Irregular Intake",
refLineDayX: "Day {{x}}",
refLineIrregularIntake: "Irregular",
refLineDayX: "D{{x}}",
refLineMin: "Min",
refLineMax: "Max",
// Settings
diagramSettings: "Diagram Settings",
pharmacokineticsSettings: "Pharmacokinetics Settings",
advancedSettings: "Advanced Settings",
advancedSettingsWarning: "⚠️ These parameters affect simulation accuracy and may deviate from population averages. Adjust only if you have specific clinical data or research references.",
xAxisTimeFormat: "Time Format",
xAxisFormatContinuous: "Continuous",
xAxisFormatContinuousDesc: "Endless sequence (0h, 6h, 12h...)",
@@ -62,25 +63,82 @@ export const en = {
xAxisFormat24hDesc: "Repeating 0-24h cycle",
xAxisFormat12h: "Time of Day (12h AM/PM)",
xAxisFormat12hDesc: "Repeating 12h cycle in AM/PM format",
showTemplateDayInChart: "Show Regular Plan (Only for Deviating Days)",
showDayReferenceLines: "Show Day Separators (Vertical Reference Lines and Status)",
showTherapeuticRangeLines: "Show Therapeutic Range (Horizontal Min/Max Reference Lines)",
showTemplateDayInChart: "Continuously Show Regular Plan",
showTemplateDayTooltip: "Display the regular medication plan as reference overlay at all times (default: enabled).",
simulationSettings: "Simulation Settings",
showDayReferenceLines: "Show Day Separators",
showDayReferenceLinesTooltip: "Display vertical lines and status indicators separating days (default: enabled).",
showTherapeuticRangeLines: "Show Therapeutic Range",
showTherapeuticRangeLinesTooltip: "Display horizontal reference lines for therapeutic min/max concentrations (default: enabled).",
simulationDuration: "Simulation Duration",
simulationDurationTooltip: "Number of days to simulate. Longer periods allow steady-state observation. Default: {{simulationDays}} days.",
displayedDays: "Visible Days (in Focus)",
yAxisRange: "Y-Axis Range (Zoom)",
displayedDaysTooltip: "How many days to display on screen at once. Smaller values zoom in on details. Default: {{displayedDays}} day(s).",
yAxisRange: "Y-Axis Range (Concentration Zoom)",
yAxisRangeTooltip: "Manually set vertical axis limits (concentration scale). Leave empty for automatic scaling based on data. Default: auto.",
yAxisRangeAutoButton: "A",
yAxisRangeAutoButtonTitle: "Determine range automatically based on data range",
auto: "Auto",
therapeuticRange: "Therapeutic Range (Reference Lines)",
therapeuticRange: "Therapeutic Range",
therapeuticRangeTooltip: "Reference concentrations for medication efficacy. Typical adult range: 5-25 ng/mL. Individual therapeutic windows vary significantly. Default: {{therapeuticRangeMin}}-{{therapeuticRangeMax}} ng/mL. Consult your physician.",
dAmphetamineParameters: "d-Amphetamine Parameters",
halfLife: "Half-life",
lisdexamfetamineParameters: "Lisdexamfetamine Parameters",
conversionHalfLife: "Conversion Half-life",
absorptionRate: "Absorption Rate",
halfLife: "Elimination Half-life",
halfLifeTooltip: "Time for body to clear half the d-amphetamine from blood. Affected by urine pH: acidic (<6) → 7-9h, neutral (6-7.5) → 10-12h, alkaline (>7.5) → 13-15h. See [therapeutic reference ranges](https://www.thieme-connect.com/products/ejournals/pdf/10.1055/a-2689-4911.pdf). Default: {{damphHalfLife}}h.",
lisdexamfetamineParameters: "Lisdexamfetamine (LDX) Parameters",
conversionHalfLife: "LDX→d-Amph Conversion Half-life",
conversionHalfLifeTooltip: "Time for red blood cells to convert half the inactive LDX prodrug into active d-amphetamine. Typical: 0.7-1.2h. Default: {{ldxHalfLife}}h.",
absorptionHalfLife: "Absorption Half-life",
absorptionHalfLifeTooltip: "Time for intestines to absorb half the LDX from stomach to blood. Delayed by food (~1h shift). Typical: 0.7-1.2h. Default: {{ldxAbsorptionHalfLife}}h.",
faster: "(faster >)",
resetAllSettings: "Reset All Settings", resetDiagramSettings: "Reset Diagram Settings",
// Advanced Settings
weightBasedVdScaling: "Weight-Based Volume of Distribution",
weightBasedVdTooltip: "Adjusts plasma concentrations based on body weight (proportional to ~5.4 L/kg). Lighter persons → higher peaks, heavier → lower peaks. When disabled, assumes 70 kg adult.",
bodyWeight: "Body Weight",
bodyWeightTooltip: "Your body weight for concentration scaling. Used to calculate volume of distribution (Vd = weight × 5.4). See [population PK analysis](https://pmc.ncbi.nlm.nih.gov/articles/PMC5572767/). Default: {{bodyWeight}} kg.",
bodyWeightUnit: "kg",
foodEffectEnabled: "Taken With Meal",
foodEffectTooltip: "High-fat meals delay absorption without changing total exposure. Slows onset of effects (~1h delay). When disabled, assumes fasted state.",
tmaxDelay: "Absorption Delay",
tmaxDelayTooltip: "How much the meal delays absorption (Tmax shift). See [food effect study](https://pmc.ncbi.nlm.nih.gov/articles/PMC4823324/) by Ermer et al. Typical: 1.0h for high-fat meal. Default: {{tmaxDelay}}h.",
tmaxDelayUnit: "h",
urinePHTendency: "Urine pH Effects",
urinePHTooltip: "Urine pH affects kidney reabsorption of amphetamine. Enables pH-dependent half-life variation (7-15h range). When disabled, assumes neutral pH (~11h HL).",
urinePHValue: "pH Value",
urinePHValueTooltip: "Your typical urine pH (acidic=faster clearance, alkaline=slower). Default: {{phTendency}}. Range: 5.5-8.0.",
phValue: "pH Value",
phUnit: "(5.5-8.0)",
oralBioavailability: "Oral Bioavailability",
oralBioavailabilityTooltip: "Fraction of LDX dose that reaches bloodstream. See [bioavailability study](https://www.frontiersin.org/journals/pharmacology/articles/10.3389/fphar.2022.881198/full) (FDA label: 96.4%). Rarely needs adjustment unless you have documented absorption issues. Default: {{fOral}} ({{fOralPercent}}%).",
steadyStateDays: "Medication History",
steadyStateDaysTooltip: "Number of prior days on stable medication dose to simulate accumulation/steady-state. Set 0 for \"first day from scratch.\" Default: {{steadyStateDays}} days. Max: 7.",
resetAllSettings: "Reset All Settings",
resetDiagramSettings: "Reset Diagram Settings",
resetPharmacokineticSettings: "Reset Pharmacokinetic Settings",
resetPlan: "Reset Plan",
// Disclaimer Modal
disclaimerModalTitle: "Important Medical Disclaimer",
disclaimerModalSubtitle: "Please read carefully before using this simulation tool",
disclaimerModalPurpose: "Purpose & Limitations",
disclaimerModalPurposeText: "This application provides theoretical pharmacokinetic simulations based on population average parameters. It is NOT a medical device and is for educational and informational purposes only.",
disclaimerModalVariability: "Individual Variability",
disclaimerModalVariabilityText: "Drug metabolism varies significantly due to body weight, kidney function, urine pH, genetics, and other factors. Real-world plasma concentrations may differ by 30-40% or more from these estimates.",
disclaimerModalMedicalAdvice: "Medical Consultation Required",
disclaimerModalMedicalAdviceText: "Do NOT use this data to adjust your medication dosage. Always consult your prescribing physician for medical decisions. Improper dose adjustments can cause serious harm.",
disclaimerModalDataSources: "Data Sources",
disclaimerModalDataSourcesText: "Simulations utilize established pharmacokinetic models incorporating parameters from: Ermer et al. (2016), Boellner et al. (2010), Roberts et al. (2015), and FDA Prescribing Information for Vyvanse®/Elvanse®.",
disclaimerModalScheduleII: "Controlled Substance Warning",
disclaimerModalScheduleIIText: "Lisdexamfetamine is a controlled substance (Schedule II) with moderate abuse and dependence potential compared to active dexamphetamine. Improper or abusive use can lead to serious health consequences as well as legal repercussions.",
disclaimerModalLiability: "No Warranties or Guarantees",
disclaimerModalLiabilityText: "This is a hobbyist/educational project with no commercial intent. The developer provides no warranties, guarantees, or liability. Use entirely at your own risk.",
disclaimerModalAccept: "I Understand - Continue to App",
disclaimerModalFooterLink: "Medical Disclaimer & Data Sources",
// Units
unitMg: "mg",
unitNgml: "ng/ml",
@@ -97,16 +155,25 @@ export const en = {
// Number input field
buttonClear: "Clear field",
// Field validation
errorNumberRequired: "Please enter a valid number.",
errorTimeRequired: "Please enter a valid time.",
warningDuplicateTime: "Multiple doses at same time.",
warningZeroDose: "Zero dose has no effect on simulation.",
halfLifeRequired: "Half-life is required.",
conversionHalfLifeRequired: "Conversion half-life is required.",
absorptionRateRequired: "Absorption rate is required.",
therapeuticRangeMinRequired: "Minimum therapeutic range is required.",
therapeuticRangeMaxRequired: "Maximum therapeutic range is required.",
// Field validation - Errors
errorNumberRequired: "Please enter a valid number.",
errorTimeRequired: "Please enter a valid time.",
errorHalfLifeRequired: "⛔ Half-life is required.",
errorConversionHalfLifeRequired: "⛔ Conversion half-life is required.",
errorAbsorptionRateRequired: "⛔ Absorption rate is required.",
errorTherapeuticRangeMinRequired: "⛔ Minimum therapeutic range is required.",
errorTherapeuticRangeMaxRequired: "⛔ Maximum therapeutic range is required.",
errorEliminationHalfLifeRequired: "⛔ Elimination half-life is required.",
// Field validation - Warnings
warningDuplicateTime: "⚠️ Multiple doses at same time.",
warningZeroDose: "⚠️ Zero dose has no effect on simulation.",
warningAbsorptionOutOfRange: "⚠️ Typical range: 0.7-1.2h. Current value may be outside clinical norms.",
warningConversionOutOfRange: "⚠️ Typical range: 0.7-1.2h. Current value may be outside clinical norms.",
warningEliminationOutOfRange: "⚠️ Typical range: 9-12h (normal pH). Extended range 7-15h (pH effects). Current value is unusual.",
warningDoseAbove70mg: "⚠️ FDA-approved maximum: 70 mg. Higher doses lack safety data and increase cardiovascular risk.",
// Time picker
timePickerHour: "Hour",