rnwatanabe / remoto

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

#ReMoto

This repository has the Java code to a web-based neuronal simulation system. It has been developed over the last ten years by some authors, including me. The version in this repository is the code as I am using it now. An on-line version of this simulator can be found in: http://remoto.leb.usp.br.

ReMoto is a web-based neuronal simulation system, intended for studying spinal cord neuronal networks responsible for muscle control. These networks are affected by descending drive, afferent drive, and electrical nerve stimulation. The simulator may be used to investigate phenomena at several levels of organization, e.g., at the neuronal membrane level or at the whole muscle behavior level (e.g., muscle force generation). This versatility is due to the fact that each element (neurons, synapses, muscle fibers) has its own specific mathematical model, usually involving the action of voltage- or neurotransmitter-dependent ionic channels. The simulator should be helpful in activities such as interpretation of results obtained from neurophysiological experiments in humans, proposal of hypothesis or testing models or theories on neuronal dynamics or neuronal network processing, validation of experimental protocols, and teaching neurophysiology.

The elements that take part in the system belong to the following classes: motoneurons, muscle fibers (electrical activity and force generation), Renshaw cells, Ia inhibitory interneurons, Ib inhibitory interneurons, Ia and Ib afferents. The neurons are interconnected by chemical synapses, which can be exhibit depression or facilitation.

The system simulates the following nuclei involved in flexion and extension of the human ankle: Medial Gastrocnemius (MG), Lateral Gastrocnemius (LG), Soleus (SOL), and Tibialis Anterior (TA).

How to cite this work

If you use this code, please cite the following papers:

"CISI, R. R. L.; KOHN, A. F. Simulation system of spinal cord motor nuclei and associated nerves and muscles, in a Web-based architecture. Journal of Computational Neuroscience, v. 25, n. 3, p. 520–542, 2008"

"ELIAS, L. A.; CHAUD, V. M.; KOHN, A. F. Models of passive and active dendrite motoneuron pools and their differences in muscle force control. Journal of Computational Neuroscience, Springer Netherlands, v. 33, n. 3, p. 515–531, 2012."

"ELIAS, L. A.; KOHN, A. F. Individual and collective properties of computationally efficient motoneuron models of types S and F with active dendrites. Neurocomputing, v. 99, p. 521–533, 2013."

"WATANABE, R. N. et al. Influences of premotoneuronal command statistics on the scaling of motor output variability during isometric plantarflexion. Journal of Neurophysiology, v. 110, n. 11, p. 2592–2606, set. 2013."

"ELIAS, L. A.; WATANABE, R. N.; KOHN, A. F. Spinal mechanisms may provide a combination of intermittent and continuous control of human posture: predictions from a biologically based neuromusculoskeletal model. PLoS Computational Biology, v. 10, n. 11, p. e1003944, nov. 2014."

"WATANABE, R. N.; KOHN, A. F. Fast Oscillatory Commands from the Motor Cortex Can Be Decoded by the Spinal Cord for Force Control. Journal of Neuroscience, v. 35, n. 40, p. 13687–13697, 2015."

The Bibtex file of these references can be found here.

How to install

The install process can be a little bit difficult due to the Web structure. I tried to give a step-by-step instruction but there is not any guarantee that these steps will work. If you have any problem during the installation, please contact me. The system has been tested in Windows and Ubuntu systems.

1 - Downloand Java SE JDK, Tomcat 7.0 and Eclipse.

2 - Install Java SE JDK, Tomcat 7.0 and Eclipse.

3 - Copy all the files into a folder named "remoto". The address of this folder will be called in this text as "remotoPath"

4 - Open the Eclipse and point the workspace to the folder "remotoPath".

5 - Click "Help" -> "Install New Software".

6 - Install the following:

* Eclipse Java EE Developer Tools

* Eclipse Java Web Developer Tools

* Eclipse Web Developer Tools

* JST Server Adapters

* JST Server adapters Extensions

* JST UI

7 - Restart Eclipse;

8 - Click "Window" -> "Preferences".

9 - Inside "Preferences" double-click "Server" -> "Runtime Environments".

10 - If the Tomcat runtime environment is present, remove it.

11 - Create a new "Apache Tomcat 7.0" runtime environment and configure the Installation directory to the folder you installed Tomcat 7.0.

12 - In the "Project Explorer" tab in the Worspace, click in the "remoto" project.

13 - Click "Project" -> "Properties".

14 - Inside "Properties" click "Java Build Path". Select the tab "Libraries".

15 - If the "JRE System Library" is present, remove it.

16 - Click "Add Library" and select "JRE System Library". Click "Next" and then "Finish".

17 - In the "Servers" tab delete any existent Server.

18 - Left-click inside the "Servers" tab and click "New" -> "Server"

19 - Select "Tomcat v7.0 Server" and click "Next".

20 - In the "Available" box, click in "remoto" and then click "Add" and "Finish".

21 - Double click in "Tomcat v7.0 Server at localhost" at the "Server" tab.

22 - A new Tab will open. Click in "Ports".

23 - Change the Port Number of the "HTTP/1.1" Port to 80.

24 - At the "Project Explorer" tab in the Workspace click, "Java Resources"->"src"->"br.remoto"->"dao".

25 - Double-click at the "BasicDAO.java" file.

26 - At the line 46, substitute "143.107.162.166" by the IP address of your computer. Save the file.

27 - At the "remotoPath" Folder, open the "WebContent/db" folder. Open the file "start.sh" (if you are using Linux) or "start.bat" (if you are using Windows) in any text editor.

28 - In this file, subsititute the address of the hsqldb.jar file to "remotoPath/WebContent/WEB-INF/lib/hsqldb.jar" and the address of the remoto database to "remotoPath/WebContent/db/remoto". Save the file.

If you do not have a Static IP address substitute the steps 23-26 by the following:

23.1 - Maintain the Port Number of the "HTTP/1.1" Port as 8080.

24.1 - At the "Project Explorer" tab in the Workspace click, "Java Resources"->"src"->"br.remoto"->"dao".

25.1 - Double-click at the "BasicDAO.java" file.

26.1 - At the line 46, substitute "143.107.162.166" by "localhost". Save the file. 

Steps to execute:

1 - Execute the file "start.sh" (if you are using Linux) or "start.bat" (if you are using Windows).

2 - Open the Eclipse and point the workspace to the folder "remotoPath".

3 - In the "Servers" tab, left-click in "Tomcat v7.0 Server at localhost". Click "Start".

4 - In a web-browser, type "youripaddress/remoto/overview.htm". "youripaddress" is the IP address of your computer.

5 - If you do not have a Static IP address and followed step 27.1 during the installation process, type in a web-browser "localhost:8080/remoto/overview.htm".

5 - After any change in the code, you have to save the files and Restart the server by left-clicking in "Tomcat v7.0 Server at localhost" and then click "Restart".

About


Languages

Language:Java 79.6%Language:JavaScript 13.7%Language:CSS 5.5%Language:HTML 1.1%Language:TeX 0.1%Language:Shell 0.0%Language:Batchfile 0.0%