# LMT Widget Tool (LWT)
The LMT Widget Tool is as tool designed to facilitate the extraction and analysis of behavioral data from .sqlite databases from the Live Mouse Tracker (LMT).
It helps users with no programming experience to easily visualize, analyze and extract relevant analysis.
You will find more information about LMT on its [website](https://livemousetracker.org/) and [publication](https://www.nature.com/articles/s41551-019-0396-1.epdf?shared_access_token=8wpLBUUytAaGAtXL96vwIdRgN0jAjWel9jnR3ZoTv0MWp3GqbF86Gf14i30j-gtSG2ayVLmU-s57ZbhM2WJjw18inKlRYt31Cg_hLJbPCqlKdjWBImyT1OrH5tewfPqUthmWceoct6RVAL_Vt8H-Og%3D%3D).
In our tool, we used the [LMT-Analysis](https://github.com/fdechaumont/lmt-analysis) repo v1.0.6, from [Fabrice de Chaumont](https://github.com/fdechaumont) with only few changes for our tool to work.
If you have any questions or comments, feel free to contact us, Damien (damien.huzard@igf.cnrs.fr) or Paul (paul.carrascosa@igf.cnrs.fr).
## 1. Download (and unzipping)
First of all, you will need to download the folder which contains all of the files to run the tool:<br><br>
<br><br>
Place the ZIP file in the folder of your choice, unzip it (for example with [7-Zip](https://www.7-zip.org/download.html)).<br>
## 2. Installation steps (for Windows users):
### 2.1. Python
To make the tool work, you will need Python version 3.10.11. Download the [3.10.11 Python version here](https://www.python.org/downloads/release/python-31011/). Go down until the 'Files' section and install `Windows installer (64-bit)` (64-bit is recommended but if your computer is on a 32-bit OS you should download the 32-bit version).<br><br>
<br><br>
Then, execute the .exe file you just downloaded.
## **! WARNING !**<br>
During the installation, make sure to check the box "Add python.exe to PATH" and click on "Install now" until Python is installed:<br><br>
<br><br>
### 2.2. LWTools
Once you have installed Python, open your command prompt to install the tool. (To open the command prompt, press the keys Windows + R, then type "cmd" and press Enter.) In your command prompt, put the following command :
```bash
pip install LWTools
```
this command will automatically install the latest version of our LWTools library from the [pypi website](https://pypi.org/project/LWTools/).
## 3. Launch Jupyter Lab
Each time you want to use the tool, you will have to launch Jupyter Lab first.
To launch Jupyter Lab, open a command prompt and write (or copy-paste):
```bash
jupyter lab
```
This will open a Jupyter Lab tab in your favorite web browser. (! Warning ! if you close the command prompt it will also close the Jupyter Lab session).
## 4. Launching the LWTools notebook
Once Jupyter Lab is launched, go to the folder you downloaded from Github during the step <b> 1. Download (and unzipping) </b> and open the <b> scripts </b> folder (e.g. '...\LMT_Widget_Tool-LWT-main\scripts').
## **! WARNING !**
Before using the tool, make sure to restart the kernel to clear it :<br><br>
<br><br>
Sometimes you will need to restart the kernel when it seems that the tool crashed, but don’t do it when it’s running !
Then, you can enjoy the tool, by opening the <b>LMT_Widget_Tool.ipynb</b> and running it within Jupyter Lab! (If so far, you never used a jupyter lab before, we recommend trying [that tutorial](https://jupyter.org/try-jupyter/lab/?path=notebooks%2FIntro.ipynb)).
<br><br>
## Order for analysis<br>
First, you will have to execute the first cell code to install the packages for the tool. Click on the cell you want to execute and press the keys Ctrl + Enter <br><br>
### Rebuild databases and convert into csv files
<br><br>
The part 1 will rebuild the databases by deleting the data and rebuild them using the detections and export these data into csv files. It is recommanded to do timebins of 5 or 10 minutes for each bin<br><br>
### **! WARNING !** for 1.1<br><br>
<br><br>
The part 1.1 is optional. It is usefull only if you want to convert your data into csv using different timebins. So be careful with this code cell, use it only if you want to change the timebins of your data.<br><br>
<br><br>
The part 2 will merge the csv files created into one csv file which will be used by the tool for the analysis.<br><br>
<br><br>
The part 3 will start the tool, you will need to use the merged file that you will have with the third part.<br><br>
## Contributing
Pull requests are welcome. For major changes, please open an issue first
to discuss what you would like to change.
Please make sure to update tests as appropriate.
## Future developments
We are also planning to improve and extend to possibilities of this tool, you can also send us your suggestions and feedbacks! <br>
Here are few ideas of future developments:<br>
- More statistical analyses
- defining ROI from your LMT cages (defining zones of interest, like food-zone, house, ...)
- Graphs of distance
- exporting all graphs and stats at once
## Another Cool LMT Tool
If you do not know it yet, please have a look to Nicolas Torquet's own [LMT_toolkit_analysis](https://github.com/ntorquet/lmt_toolkit_analysis)! It is really a powerful way to extract and visualize data from your .sqlite directly. <br>
It might be still a bit harder to install and run than our tool, but it is a beautiful and inspiring initiative! Try it and let him/us know!
## License
LMT_Widget_Tool is released under the GNU GPL v3.0 licence. See the [LICENSE](LICENSE) file.
Copyright (C) 2023 IGF - CNRS - INSERM - Université de Montpellier
LMT_Widget_Tool uses the LMT-analysis code provided on [GitHub](https://github.com/fdechaumont/lmt-analysis). This code is also under the GNU GPL v3.0 licence.
[GNU GPL ?](https://choosealicense.com/licenses/mit/)
Raw data
{
"_id": null,
"home_page": "https://github.com/PaulCarrascosa/LMT_Widget_Tool-LWT",
"name": "LWTools",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "",
"keywords": "Live Mouse Tracker,LMT,Tool,Data analysis",
"author": "Paul Carrascosa, Damien Huzard",
"author_email": "paul.carrascosa@igf.cnrs.fr",
"download_url": "https://files.pythonhosted.org/packages/c6/28/10724b14295e129f00cfe16407a7f29035e8f35bde9ebec98a83f155c652/LWTools-1.1.1.tar.gz",
"platform": null,
"description": "# LMT Widget Tool (LWT)\r\n\r\nThe LMT Widget Tool is as tool designed to facilitate the extraction and analysis of behavioral data from .sqlite databases from the Live Mouse Tracker (LMT).\r\nIt helps users with no programming experience to easily visualize, analyze and extract relevant analysis.\r\n\r\nYou will find more information about LMT on its [website](https://livemousetracker.org/) and [publication](https://www.nature.com/articles/s41551-019-0396-1.epdf?shared_access_token=8wpLBUUytAaGAtXL96vwIdRgN0jAjWel9jnR3ZoTv0MWp3GqbF86Gf14i30j-gtSG2ayVLmU-s57ZbhM2WJjw18inKlRYt31Cg_hLJbPCqlKdjWBImyT1OrH5tewfPqUthmWceoct6RVAL_Vt8H-Og%3D%3D).\r\n\r\nIn our tool, we used the [LMT-Analysis](https://github.com/fdechaumont/lmt-analysis) repo v1.0.6, from [Fabrice de Chaumont](https://github.com/fdechaumont) with only few changes for our tool to work.\r\n\r\nIf you have any questions or comments, feel free to contact us, Damien (damien.huzard@igf.cnrs.fr) or Paul (paul.carrascosa@igf.cnrs.fr).\r\n\r\n## 1. Download (and unzipping)\r\n\r\nFirst of all, you will need to download the folder which contains all of the files to run the tool:<br><br>\r\n<br><br>\r\nPlace the ZIP file in the folder of your choice, unzip it (for example with [7-Zip](https://www.7-zip.org/download.html)).<br>\r\n\r\n## 2. Installation steps (for Windows users):\r\n### 2.1. Python\r\n\r\nTo make the tool work, you will need Python version 3.10.11. Download the [3.10.11 Python version here](https://www.python.org/downloads/release/python-31011/). Go down until the 'Files' section and install `Windows installer (64-bit)` (64-bit is recommended but if your computer is on a 32-bit OS you should download the 32-bit version).<br><br>\r\n<br><br>\r\nThen, execute the .exe file you just downloaded.\r\n\r\n## **! WARNING !**<br>\r\nDuring the installation, make sure to check the box \"Add python.exe to PATH\" and click on \"Install now\" until Python is installed:<br><br>\r\n<br><br>\r\n\r\n### 2.2. LWTools\r\n\r\nOnce you have installed Python, open your command prompt to install the tool. (To open the command prompt, press the keys Windows + R, then type \"cmd\" and press Enter.) In your command prompt, put the following command :\r\n\r\n```bash\r\npip install LWTools\r\n```\r\nthis command will automatically install the latest version of our LWTools library from the [pypi website](https://pypi.org/project/LWTools/).\r\n\r\n## 3. Launch Jupyter Lab\r\n\r\nEach time you want to use the tool, you will have to launch Jupyter Lab first. \r\n\r\nTo launch Jupyter Lab, open a command prompt and write (or copy-paste):\r\n```bash\r\njupyter lab\r\n```\r\nThis will open a Jupyter Lab tab in your favorite web browser. (! Warning ! if you close the command prompt it will also close the Jupyter Lab session).\r\n\r\n## 4. Launching the LWTools notebook\r\n\r\nOnce Jupyter Lab is launched, go to the folder you downloaded from Github during the step <b> 1. Download (and unzipping) </b> and open the <b> scripts </b> folder (e.g. '...\\LMT_Widget_Tool-LWT-main\\scripts').\r\n\r\n## **! WARNING !**\r\n\r\nBefore using the tool, make sure to restart the kernel to clear it :<br><br>\r\n<br><br>\r\nSometimes you will need to restart the kernel when it seems that the tool crashed, but don\u2019t do it when it\u2019s running !\r\n\r\nThen, you can enjoy the tool, by opening the <b>LMT_Widget_Tool.ipynb</b> and running it within Jupyter Lab! (If so far, you never used a jupyter lab before, we recommend trying [that tutorial](https://jupyter.org/try-jupyter/lab/?path=notebooks%2FIntro.ipynb)).\r\n<br><br>\r\n\r\n## Order for analysis<br>\r\n\r\nFirst, you will have to execute the first cell code to install the packages for the tool. Click on the cell you want to execute and press the keys Ctrl + Enter <br><br>\r\n\r\n### Rebuild databases and convert into csv files\r\n\r\n<br><br>\r\nThe part 1 will rebuild the databases by deleting the data and rebuild them using the detections and export these data into csv files. It is recommanded to do timebins of 5 or 10 minutes for each bin<br><br>\r\n\r\n### **! WARNING !** for 1.1<br><br>\r\n<br><br>\r\nThe part 1.1 is optional. It is usefull only if you want to convert your data into csv using different timebins. So be careful with this code cell, use it only if you want to change the timebins of your data.<br><br>\r\n\r\n<br><br>\r\nThe part 2 will merge the csv files created into one csv file which will be used by the tool for the analysis.<br><br>\r\n\r\n<br><br>\r\nThe part 3 will start the tool, you will need to use the merged file that you will have with the third part.<br><br>\r\n\r\n## Contributing\r\n\r\nPull requests are welcome. For major changes, please open an issue first\r\nto discuss what you would like to change.\r\n\r\nPlease make sure to update tests as appropriate.\r\n\r\n## Future developments\r\n\r\nWe are also planning to improve and extend to possibilities of this tool, you can also send us your suggestions and feedbacks! <br>\r\nHere are few ideas of future developments:<br>\r\n - More statistical analyses\r\n - defining ROI from your LMT cages (defining zones of interest, like food-zone, house, ...)\r\n - Graphs of distance\r\n - exporting all graphs and stats at once\r\n\r\n## Another Cool LMT Tool\r\n\r\nIf you do not know it yet, please have a look to Nicolas Torquet's own [LMT_toolkit_analysis](https://github.com/ntorquet/lmt_toolkit_analysis)! It is really a powerful way to extract and visualize data from your .sqlite directly. <br>\r\nIt might be still a bit harder to install and run than our tool, but it is a beautiful and inspiring initiative! Try it and let him/us know!\r\n\r\n## License\r\n\r\nLMT_Widget_Tool is released under the GNU GPL v3.0 licence. See the [LICENSE](LICENSE) file.\r\n\r\nCopyright (C) 2023 IGF - CNRS - INSERM - Universit\u00e9 de Montpellier\r\n\r\nLMT_Widget_Tool uses the LMT-analysis code provided on [GitHub](https://github.com/fdechaumont/lmt-analysis). This code is also under the GNU GPL v3.0 licence.\r\n[GNU GPL ?](https://choosealicense.com/licenses/mit/)\r\n",
"bugtrack_url": null,
"license": "GNU General Public License v3 (GPLv3)",
"summary": "Tool for LMT data analysis",
"version": "1.1.1",
"project_urls": {
"Homepage": "https://github.com/PaulCarrascosa/LMT_Widget_Tool-LWT"
},
"split_keywords": [
"live mouse tracker",
"lmt",
"tool",
"data analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7df2f57cfeb329f09031e936b25224cfb6f90e5c284efbbb5695a1f247076a64",
"md5": "a64c5511852373acb9a27ea517c69738",
"sha256": "4389165c971763dfcfb1b0377245295a4ed628f66b3ccf3cd961f2d37795c2dd"
},
"downloads": -1,
"filename": "LWTools-1.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a64c5511852373acb9a27ea517c69738",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 164386,
"upload_time": "2024-02-27T09:51:00",
"upload_time_iso_8601": "2024-02-27T09:51:00.462547Z",
"url": "https://files.pythonhosted.org/packages/7d/f2/f57cfeb329f09031e936b25224cfb6f90e5c284efbbb5695a1f247076a64/LWTools-1.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c62810724b14295e129f00cfe16407a7f29035e8f35bde9ebec98a83f155c652",
"md5": "306dfaa272c07db4d5d39153caee0d28",
"sha256": "eed8242e73084c2a5dc713c6821707d0a098a02b1c133723cfba09649be765d5"
},
"downloads": -1,
"filename": "LWTools-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "306dfaa272c07db4d5d39153caee0d28",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 122480,
"upload_time": "2024-02-27T09:51:02",
"upload_time_iso_8601": "2024-02-27T09:51:02.923987Z",
"url": "https://files.pythonhosted.org/packages/c6/28/10724b14295e129f00cfe16407a7f29035e8f35bde9ebec98a83f155c652/LWTools-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-27 09:51:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "PaulCarrascosa",
"github_project": "LMT_Widget_Tool-LWT",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "lwtools"
}
JSON
