|
1 |
| -JS electron based version of PMTools. |
| 1 | +# PMTools beta |
| 2 | + |
| 3 | +PMTools is a program for analyzing paleomagnetic data performing a full cycle of paleomagnetic operations (component analysis, direction statistics, computation of poles). |
| 4 | + |
| 5 | +It is a beta version, may be various bugs. If you find any bug, please report this ([create an issue](https://github.com/I194/PMTools/issues) in this repo). |
| 6 | + |
| 7 | +--- |
| 8 | + |
| 9 | +## Features |
| 10 | + |
| 11 | +### Import and export |
| 12 | + |
| 13 | +PMTools currently supports the following input formats: |
| 14 | +* pmd |
| 15 | +* cit (.sam, not tested) |
| 16 | +* jra (not testing) |
| 17 | +* jr6 (not tested) |
| 18 | +* cit (not tested) |
| 19 | +* magic (limited set of params, only measurements, not tested) |
| 20 | +* pmm |
| 21 | +* dir |
| 22 | +* rs3 (not tested) |
| 23 | +* csv & xlsx (internal formats) |
| 24 | + |
| 25 | +Also, thanks to the [paleomagnetism.org](https://paleomagnetism.org/) open source policy, there are import functions for file formats used in some institutions&labs: |
| 26 | +* Black Mountain Lab |
| 27 | +* Cenieh |
| 28 | +* Geological Survay of Finland |
| 29 | +* Geological Survay of Norway |
| 30 | +* University of Barselona |
| 31 | +* University of Helsinki |
| 32 | +* University of Montpellier |
| 33 | +* University of Oxford |
| 34 | +* University of Oslo |
| 35 | +* University of Munich |
| 36 | +* University of Rennes |
| 37 | +* University of Utrecht |
| 38 | + |
| 39 | +However, due to the lack of real examples of files with such formats, they were not added to the PMTools. If you want your format to be added to PMTools - please report this ([create an issue](https://github.com/I194/PMTools/issues) in this repo or write me to i1948374@gmail.com). |
| 40 | + |
| 41 | +You can find examples of some input files used in my laboratory and with which PMTools should work correctly in the [Import_examples](https://github.com/I194/PMTools/tree/main/Import_examples). |
| 42 | + |
| 43 | +Files export in PMTools is possible only in .csv and .xlsx formats. Soon, the export in MagIC format will be implemented (you can already find the export window in the program, but it does not work yet). |
| 44 | + |
| 45 | +### Charts |
| 46 | + |
| 47 | +All charts in PMTools are created using ```highcharts.js```, their appearance is as simple as possible and allows you to use them almost immediately after export as graphic material for presentations and/or publications. |
| 48 | + |
| 49 | +All charts have their own settings that are called when you right-click on them (context menu). |
| 50 | + |
| 51 | +### Shortcuts |
| 52 | + |
| 53 | +PMTools supports keyboard shortcuts, which you can see in Help> Shortcuts. They are the same as in Enkin's software for DOS. |
| 54 | + |
| 55 | +### Paleomagnetic tests |
| 56 | + |
| 57 | +Paleomagnetic statistical tests (fold test, conglomerate test, reversal test and test for common mean) are implemented, corresponding to the tests from PmagPY (plot analysis notebook). |
| 58 | + |
| 59 | +--- |
| 60 | +## Documentation |
| 61 | + |
| 62 | +You can find the documentation for PMTools in this repository in the [Manual folder](https://github.com/I194/PMTools/tree/main/Manual). Unfortunately, I have not yet managed to write a full-fledged documentation in English, but it will be added soon. As a brief overview of PMTools you can use my poster about PMTools for MagIC workshop 2021. I apologize for the inconvenience. |
| 63 | + |
| 64 | +--- |
| 65 | +## PMTools install |
| 66 | + |
| 67 | +You can find latest installers of PMTools beta in the [releases page](https://github.com/I194/PMTools/releases). |
| 68 | + |
| 69 | +Mac and Linux versions will be added soon. |
| 70 | + |
| 71 | +--- |
| 72 | +## Licensing |
| 73 | + |
| 74 | +The source code for PMTools is licensed under MIT that can be found under the LICENSE file. |
| 75 | + |
| 76 | +--- |
| 77 | +## Development history and current state |
| 78 | + |
| 79 | +PMTools was originally created as a simple program for component analysis, therefore it was originally written in python3 (as part of my 2019-2020 coursework). However, in February 2020 (1.5 months before the release of PMTools alpha) v2.0.0 was released. I was extremely impressed with this site - I really liked the graphic component and the idea itself. However, my colleagues for a number of reasons did not satisfied by paleomagnetism.org v2.0.0., and therefore I decided to go further in the development of PMTools and create a new program for the analysis of paleomagnetic data. |
| 80 | + |
| 81 | +Impressed by [paleomagnetism.org](https://paleomagnetism.org/), I decided to create a JS version of PMTools using ```highcharts.js```. However, an important requirement from my colleagues was the autonomy of the program, so I used the ```electron.js``` framework and created a desktop application. |
| 82 | + |
| 83 | +Over the summer of 2020, I created the most of the PMTools functionality that you can see now in the current version of PMTools. Unfortunately, since autumn I could not pay due attention to the development of PMTools due to my studying (I am a 3rd year student now). However, development did not stop, but it was greatly slowed down. In general, since summer 2020, the export of graphics was improved, paleomagnetic statistical tests were implemented, multiple tests of PMTools were carried out (but even more is needed) and many errors were fixed. |
| 84 | + |
| 85 | +Now the main goal is to implement export and full import of the MagIC database format files, so that users can interact with this database with maximum comfort. Unfortunately, due to the exam period, I have even less time to develop PMTools, but I'm gradually going on. |
| 86 | + |
| 87 | +--- |
| 88 | + |
| 89 | +## Appreciation |
| 90 | + |
| 91 | +I would like to express my gratitude to Roman Veselovsky for supervising the creation of PMTools; Alexander Pasenko, Ivan Lebedev and Vladimir Vodovozov for testing PMTools; Nicholas Jarbo for help with the integration with the MagIC database. |
| 92 | + |
| 93 | +I also want to thank the teams of [paleomagnetism.org](https://paleomagnetism.org/) and [PmagPY](https://github.com/PmagPy/PmagPy) for their open source policy, without access to which PMTools development would be much slower. |
| 94 | + |
| 95 | +--- |
| 96 | + |
| 97 | +Ivan Efremov |
2 | 98 |
|
3 |
| -PMTools beta v0.9.4. |
|
0 commit comments