Some Frequently Asked Questions are collected here, grouped by category.
- Q: Which version of PlantCV should I use?
- A: We suggest using the latest code from GitHub ('master' branch), as described in the installation instructions. If you are trying to reproduce the results from a specific manuscript, you may prefer to use one of the stable releases. These releases are assigned Digital Object Identifiers (DOI) and archived at Zenodo.org.
- Q: How should I cite PlantCV?
- Q: What version(s) of Python and OpenCV does PlantCV work with?
- A: PlantCV currently works with both Python 2.7 and 3+ and OpenCV 2 and 3. Python 2.7 can be used with either OpenCV 2 or 3 but Python 3 can only be used with OpenCV 3. Our recommended configuration is Python 3 and OpenCV 3. In the future, Python 2 and OpenCV 2 support will end but removing support is not currently on our roadmap.
- Q: When will the next stable version of PlantCV be released?
- A: Please see the Milestones page for target date estimates and the status of selected planned releases.
- Q: How should I grow plants and acquire images for quantitative processing?
- A: This depends on your main question of interest, and is beyond the scope of the current PlantCV documentation. We do provide some general considerations, but you may be be interested in a review article written by the lead PlantCV developers, a practical guide on growth conditions by Poorter et al. (2012), or a glossary and general advice by Roeder et al. (2012).
- Q: Can I use PlantCV to process photos taken with a Raspberry Pi camera?
- A: Yes. As noted in the 'Getting started' section, PlantCV was designed to work flexibly with many types of imagery as possible. Several groups are processing Raspberry Pi images using PlantCV, and PlantCV developers enthusiastically use Raspberry Pi cameras for outreach and training efforts and timelapse imaging. See the example scripts associated with a recently submitted protocol note. You can even run PlantCV directly on a Pi (installation instructions for Ubuntu should work well with Raspbian), but this is certainly not required. See also tutorials on the DDPSC Maker Group site.
- Q: Can PlantCV use information about the temporal relation of images
for object tracking etc.?
- A: Not at present. OpenCV includes tools for analyzing video data, so this could be added in the future.
- Q: My plants are touching,
and getting merged into a single object.
What can I do?
- A: Not much, for now. PlantCV is geared toward images of well-spaced plants. Facilities for drawing custom boundaries exist in other tools, and could in principle be added.
We try to continually improve our documentation. We have not (necessarily) written answers for the following questions. Users are encouraged to ask questions by filing an issue and also to submit candidate questions and answers via pull request.
- Q: How is PlantCV structured?
- Q: How is PlantCV tested?
- A: Unit tests are in the 'tests' directory in the root of the source tree. We use the Travis Continuous Integration tool to monitor status and test pull requests for breaking changes.
- Q: Does PlantCV follow Semantic Version Numbering
for stable releases?
- A: Not entirely. Major releases are mostly based on new features. We try to avoid changes that break compatibility between minor version releases.
- Q: Is there a naming convention for PlantCV functions?
- A: No, not at present. Please see the guide to contributing for some general advice on code style, PEP8 docstrings etc.