Skip to content

toshi-ara/sim-la-web

Repository files navigation

Simulator for local anesthetics

Summary

  • This program is a computer-based simulator that reproduces the local anesthetic training items used in student training at Matsumoto Dental University.

How to install and run

About training procedures

Procedures for animal experiments on which the simulator is based

  1. Shave the hair on the back of the guinea pig
  2. Inject 0.1 mL of the following drugs intradermally, and each injection site papule is enclosed in a circle marked by a magic marker.
    • Saline
    • Pro: Procaine hydrochloride (1%)
    • Lid: Lidocaine hydrochloride (1%)
    • Mep: Mepivacaine hydrochloride (1%)
    • Bup: Bupivacaine hydrochloride (1%)
    • Lid + Adr: Lidocaine hydrochloride (1%) with adrenaline (1/100,000)
  3. Stimulate 6 times at each papule with needle, with the number of the skin contractions counted, defining this number as the score (minimum is 0, and maximum is 6).
    • Stimulate at 5 min interval up to 120 min
  4. When a score of 6 is obtained three times in a row, finish the stimulation and define that time as the duration.
    • No need to stimulate after completion
  5. Compare the sum of score values and duration of action for each drug.

How to use the simulator

  1. Press Start button to start measurement
  2. When you click inside the circle, "Response" or "No response" will be displayed at the bottom left of the screen. If there is a response, the circle will temporarily turn red.
  3. You can change the speed (times) of time passing with the slider.
    • Values can be changed both while running and stopped.
  4. Press the Pause button to stop time passing, and press the Restart button to resume time passing
  5. You can run the experiment from the beginning with new parameter values by pressing the New Exp. button.
    • This means conducting experiments using different animals.
  6. Press the Quit button and then exit the program.
    • Please perform this operation to delete the parameter information because this remains in the browser,

Notes on this simulator

  • This simulator is modeled based on actual training results, but it may not necessarily yield the same results as animal experiments.
    • Because drug parameter values are set with random numbers, the duration of drug action may differ from the original drug order.
    • Because the presence or absence of a response when stimulated is determined by random numbers, the number of responses repeats up and down and does not necessarily increase over time.

Reference

A paper on the model formula and parameter values used in this simulator.

  • Toshiaki Ara and Hiroyuki Kitamura: Development of a Predictive Statistical Pharmacological Model for Local Anesthetic Agent Effects with Bayesian Hierarchical Model Parameter Estimation. Medicines 2023, 10(11), 61 (https://doi.org/10.3390/medicines10110061)
  • Toshiaki Ara and Hiroyuki Kitamura: Improvement of statistical models by considering correlations among parameters: Local anesthetic agent simulator for pharmacological education 2024, 4(4), 2133-2148 (https://doi.org/10.3390/biomedinformatics4040114)

Installing on a PC or modifying the source code

How to build the code

  • Requires npm (JavaScript package management system)
  1. Run the following command with npm installed
git clone https://github.com/toshi-ara/sim-la-web.git
# git clone git@github.com:toshi-ara/sim-la-web.git  # when you use ssh
cd sim-la-web

npm install
npm run build
  1. Copy the contents of the dist folder to your PC.
  2. Double-click index.html in the dist folder to launch the simulator.

How to display license

  • If you want to modify program, please edit the LICENSE file. Please add the copyright holder after Copyright (c) 2026 ARA Toshiaki and include this LICENSE file in the source code.

ChangeLog

v1.0.0 (2026-1-30)

  • First release

About this program

  • Author: Matsumoto Dental University, Department of Pharmacology, Toshiaki Ara
  • Year:2026
  • License: MIT License

About

Simulator for local anesthetics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors