[![Build Status](https://travis-ci.org/micasense/imageprocessing.svg?branch=master)](https://travis-ci.org/micasense/imageprocessing)
## MicaSense RedEdge and Altum Image Processing Tutorials
This repository includes tutorials and examples for processing MicaSense RedEdge and Altum images into usable information using the Python programming language. RedEdge images captured with firmware 2.1.0 (released June 2017) or newer are required. Altum images captured with all firmware versions are supported. Dual-camera (10-band) capture are also included.
The intended audience is researchers and developers with some software development experience that want to do their own image processing. While a number of commercial tools fully support processing RedEdge data into reflectance maps, there are a number of reasons to process your own data, including controlling the entire radiometric workflow (for academic or publication reasons), pre-processing images to be used in a non-radiometric photogrammetry suite, or processing single sets of images without building a larger map.
### What do I need to succeed?
A working knowledge of running Python software on your system and using the command line are both very helpful. We've worked hard to make these tutorials straightforward to run and understand, but the target audience is someone that's looking to learn more about how to process their own imagery and write software to perform more powerful analysis.
You can start today even if you don't have your own RedEdge or Altum. We provide example images, including full flight datasets.
For a user of RedEdge or Altum that wants a turnkey processing solution, this repository probably is not the best place to start. Instead, consider one of the MicaSense processing partners who provide turnkey software for processing and analysis.
### How do I get set up?
First, [check out the setup tutorial](https://micasense.github.io/imageprocessing/MicaSense%20Image%20Processing%20Setup.html) which will walk you through installing and checking the necessary tools to run the remaining tutorials.
Next, [click here to view the tutorial articles](https://micasense.github.io/imageprocessing/index.html). The set of example notebooks and their outputs can be viewed in your browser without downloading anything or running any code.
For a quick start, make sure you have [git](https://git-scm.com/downloads), [git-lfs](https://git-lfs.github.com/), and [Anaconda](https://www.anaconda.com/) installed.
And then:
```
git clone https://github.com/micasense/imageprocessing
cd imageprocessing
conda env create -f micasense_conda_env.yml # or pip install .
conda activate micasense
jupyter notebook .
```
### MicaSense Library Usage
In addition to the tutorials, we've created library code that shows some common transformations, usages, and applications of RedEdge and Altum imagery. In general, these are intended for developers that are familiar with installing and managing python packages and third party software. The purpose of this code is readability and clarity to help others develop processing workflows, therefore performance may not be optimal.
While this code is similar to an installable Python library (and supports the `python setup.py install` process) the main purpose of this library is one of documentation and education. For this reason, we expect most users to be looking at the source code for understanding or improvement, so they will run the notebooks from the directory that the library was `git clone`d it into.
### Running this code
The code in these tutorials consists of two parts. First, the tutorials generally end in `.ipynb` and are the Jupyter notebooks that were used to create the web page tutorials linked above. You can run this code by opening a terminal/iTerm (Linux/macOS) or Anaconda Command Prompt (Windows), navigating to the folder you cloned the git repository into, and running
```bash
jupyter notebook .
```
That command should open a web browser window showing the set of files and folder in the repository. Click the `...Setup.ipynb` notebook to get started.
Second, a set of helper utilities is available in the `micasense` folder that can be used both with these tutorials as well as separtely.
Note that some of the hyperlinks in the notebooks may give you a 404 Not Found error. This is because the links are setup to allow the list of files above to be accessed on the github.io site. When running the notebooks, use your jupyter "home" tab to open the different notebooks.
### Contribution guidelines
Find a problem with the tutorial? Please look through the existing issues (open and closed) and if it's new, [create an issue on github](https://github.com/micasense/imageprocessing/issues).
Want to correct an issue or expand library functionality? Fork the repository, make your fix, and submit a pull request on github.
Have a question? Please double-check that you're able to run the setup notebook successfully, and resolve any issues with that first. If you're pulling newer code, it may be necessary in some cases to delete and re-create your `micasense` conda environment to make sure you have all of the expected packages.
This code is a community effort and is not supported by MicaSense support. Please don't reach out to MicaSense support for issues with this codebase; instead, work through the above troubleshooting steps and then [create an issue on github](https://github.com/micasense/imageprocessing/issues).
### Tests
Tests for many library functions are included in the `tests` diretory. Install the `pytest` module through your package manager (e.g. `pip install pytest`) and then tests can be run from the main directory using the command:
```bash
pytest
```
Test execution can be relatively slow (2-3 minutes) as there is a lot of image processing occuring in some of the tests, and quite a bit of re-used IO. To speed up tests, install the `pytest-xdist` plugin using `conda` or `pip` and achieve a significant speed up by running tests in parallel.
```bash
pytest -n auto
```
Data used by the tests is included in the `data` folder.
### For (Tutorial) Developers
To generate the HTML pages after updating the jupyter notebooks, run the following command in the repository directory:
```bash
jupyter nbconvert --to html --ExecutePreprocessor.timeout=None --output-dir docs --execute *.ipynb
```
## License
The MIT License (MIT)
Copyright (c) 2017-2019 MicaSense, Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
没有合适的资源?快使用搜索试试~ 我知道了~
MicaSenseRedEdge和Altum图像处理教程_Jupyter Notebook_Python_下载.zip
共97个文件
tif:56个
py:20个
ipynb:14个
1.该资源内容由用户上传,如若侵权请联系客服进行举报
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
版权申诉
0 下载量 141 浏览量
2023-04-26
11:16:59
上传
评论
收藏 145KB ZIP 举报
温馨提示
MicaSenseRedEdge和Altum图像处理教程_Jupyter Notebook_Python_下载.zip
资源推荐
资源详情
资源评论
收起资源包目录
MicaSenseRedEdge和Altum图像处理教程_Jupyter Notebook_Python_下载.zip (97个子文件)
imageprocessing-master
MicaSense Image Processing Setup.ipynb 13KB
Captures.ipynb 3KB
Alignment-10Band.ipynb 25KB
.travis.yml 1KB
setup.py 977B
.gitattributes 84B
pytest.ini 166B
micasense_conda_env.yml 377B
Images.ipynb 3KB
data
ALTUM1SET
000
IMG_0008_3.tif 132B
IMG_0245_1.tif 132B
IMG_0000_1.tif 132B
IMG_0245_3.tif 132B
IMG_0000_2.tif 132B
IMG_0008_5.tif 132B
IMG_0000_5.tif 132B
IMG_0000_3.tif 132B
IMG_0008_4.tif 132B
IMG_0245_5.tif 132B
IMG_0008_2.tif 132B
IMG_0000_6.tif 130B
IMG_0245_4.tif 132B
IMG_0245_2.tif 132B
IMG_0008_6.tif 130B
IMG_0008_1.tif 132B
IMG_0245_6.tif 130B
IMG_0000_4.tif 132B
0001SET
000
IMG_0002_4.tif 132B
IMG_0003_1.tif 132B
ALTUM0SET
000
IMG_0000_1.tif 132B
10BANDSET
000
IMG_0000_10.tif 132B
IMG_0000_1.tif 132B
IMG_0431_6.tif 132B
IMG_0431_3.tif 132B
IMG_0000_2.tif 132B
IMG_0431_4.tif 132B
IMG_0000_5.tif 132B
IMG_0431_8.tif 132B
IMG_0431_7.tif 132B
IMG_0000_3.tif 132B
IMG_0431_2.tif 132B
IMG_0431_10.tif 132B
IMG_0431_1.tif 132B
IMG_0000_9.tif 132B
IMG_0000_6.tif 132B
IMG_0000_7.tif 132B
IMG_0431_9.tif 132B
IMG_0000_8.tif 132B
IMG_0431_5.tif 132B
IMG_0000_4.tif 132B
0002SET
000
IMG_0000_1.tif 132B
IMG_0000_2.tif 132B
IMG_0000_5.tif 132B
IMG_0000_3.tif 132B
IMG_0000_4.tif 132B
0000SET
000
IMG_0001_1.tif 132B
IMG_0000_1.tif 132B
IMG_0001_2.tif 132B
IMG_0001_5.tif 132B
IMG_0000_2.tif 132B
IMG_0000_5.tif 132B
IMG_0001_3.tif 132B
IMG_0001_4.tif 132B
IMG_0000_3.tif 132B
IMG_0000_4.tif 132B
LICENSE 1KB
index.ipynb 3KB
tests
__init__.py 1KB
test_dls.py 7KB
test_panel.py 9KB
test_imageset.py 2KB
test_image.py 5KB
test_capture.py 12KB
test_imageutils.py 5KB
test_metadata.py 5KB
conftest.py 6KB
Alignment.ipynb 30KB
ImageSets.ipynb 9KB
micasense
utils.py 7KB
__init__.py 1KB
image.py 22KB
panel.py 13KB
capture.py 30KB
plotutils.py 5KB
dls.py 6KB
imageutils.py 18KB
metadata.py 15KB
imageset.py 12KB
MicaSense Image Processing Tutorial 1.ipynb 20KB
MicaSense Image Processing Tutorial 3.ipynb 15KB
Batch Processing-10Band.ipynb 14KB
Alignment-RigRelatives.ipynb 22KB
Batch Processing.ipynb 13KB
.gitignore 160B
README.md 7KB
MicaSense Image Processing Tutorial 2.ipynb 14KB
Panels.ipynb 4KB
共 97 条
- 1
资源评论
快撑死的鱼
- 粉丝: 1w+
- 资源: 9154
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功