MorphoMetriX 2.0

A GUI for photogrammetry and morphometry

Read the Manual »

See Demo Annotations . Report Bug . Request Feature

Table Of Contents

• About the Project
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Contributing
• License
• Authors
• Acknowledgements

About The Project

Let MorphoMetriX streamline the often tedious process of making photogrammetric measurements for you, offering a quick intuitive GUI to calculate piecewise/arc lengths and width profiles along segments/curves and areas for polygons.

Also check out CollatriX¹, a GUI to collate multiple MorphoMetriX outputs into a single datafile with add-on functions for correcting altitude error from UAS (drone) flights and calculating animal body condition.

1. Bird, C.N., and Bierlich, K.C. (2020). CollatriX: A GUI to collate MorphoMetriX outputs. Journal of Open Source Software, 5(51), 2328. https://doi:10.21105/joss.02328

Getting Started

To install MorphoMetrix go to our releases page and download either the dmg (for macs) or exe (for windows). For further detail, please see our manual pdf. Continue reading if you prefer to run the source code locally.

Prerequisites

To run MorphoMetrix you need to install:

• python 3.10

Optionally, we recommend using anaconda for better control over your python environment.

Installation

1. Open your terminal and clone the repo

git clone https://github.com/ZappyMan/MorphoMetriX-V2.git

2. Install Python packages

pip install -r requirements.txt

3. Launch MorphoMetriX GUI

python3 morphometrix/__main__.py

Usage

For further detail, please see our manual pdf

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

• If you have suggestions for adding or removing projects, feel free to open an issue to discuss it, or directly create a pull request after you edit the README.md file with necessary changes.
• Please make sure you check your spelling and grammar.
• Create individual PR for each suggestion.
• Please also read through the Code Of Conduct before posting your first idea as well.

Creating A Pull Request

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Authors

• Elliott Chimienti - OSU Computer Science Graduate Student - Elliott Chimienti - Maintainer
• KC Bierlich - Postdoctoral Scholar, PhD Marine Science and Conservation - KC Bierlich
• Clara Bird - PhD Candidate, Department of Fisheries, Wildlife & Conservation Sciences - Clara Bird
• Walter Torres - Postdoctoral Researcher, PhD, Marine Science & Conservation