Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/distant-viewing/dvt
Distant Viewing Toolkit for the Analysis of Visual Culture
https://github.com/distant-viewing/dvt
computer-vision cultural-analytics digital-humanities
Last synced: 6 days ago
JSON representation
Distant Viewing Toolkit for the Analysis of Visual Culture
- Host: GitHub
- URL: https://github.com/distant-viewing/dvt
- Owner: distant-viewing
- License: gpl-2.0
- Created: 2017-01-04T03:49:45.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2024-08-29T14:17:09.000Z (4 months ago)
- Last Synced: 2024-12-29T08:08:22.208Z (13 days ago)
- Topics: computer-vision, cultural-analytics, digital-humanities
- Language: Jupyter Notebook
- Homepage: https://distantviewing.org
- Size: 132 MB
- Stars: 91
- Watchers: 10
- Forks: 12
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Distant Viewing Toolkit for the Analysis of Visual Culture
[](https://pypi.python.org/pypi/dvt/) [](https://pypi.python.org/pypi/dvt/) [](https://pypi.python.org/pypi/dvt/) [](https://doi.org/10.21105/joss.01800)
The Distant Viewing Toolkit is a Python package that facilitates the
computational analysis of still and moving images. The most recent
version of the package focuses on providing a minimal set of functions
that require only a small set of dependencies. Examples of how to make
use of the toolkit are given in the following section.
For more information about setting up the toolkit on your own machine, please
see [INSTALL.md](INSTALL.md). More information about the toolkit and project is
available on the following pages:
* Example analysis using aggregated metadata: ["Visual Style in Two Network Era Sitcoms"](https://culturalanalytics.org/article/11045-visual-style-in-two-network-era-sitcoms)
* Theory of the project: ["Distant Viewing: Analyzing Large Visual Corpora."](https://doi.org/10.1093/llc/fqz013)
* Software Whitepaper: [A Python Package for the Analysis of Visual Culture](https://doi.org/10.21105/joss.01800)
If you have any trouble using the toolkit, please open a
[GitHub issue](https://github.com/distant-viewing/dvt/issues). If you
have additional questions or are interested in collaborating, please contact
us at [email protected] and [email protected].
## Notebooks
If you are interested in learning more about application of computer vision and
the distant viewing toolkit to humanities applications, we offer a self-guided
tutorial through the following Google Colab notebooks. These can be run for free
by anyone with a Google account:
- Distant Viewing Tutorial 1: Movie Posters and Color Analysis: [[colab](https://colab.research.google.com/drive/1qQKQw8qHsTG7mK7Rz-z8nBfl98QBMWGf?usp=sharing)], [[slides](https://distantviewing.org/tutorial/dvt_tutorial_slides_01.pdf)], [[notebook](https://github.com/distant-viewing/dvt/blob/main/tutorials/Distant_Viewing_Tutorial_1_Movie_Posters_and_Color_Analysis.ipynb)], [[chapter](https://direct.mit.edu/books/oa-monograph/chapter-pdf/2163342/c001700_9780262375160.pdf)]
- Distant Viewing Tutorial 2: Network-Era Sitcoms and Visual Style: [[colab](https://colab.research.google.com/drive/1n7qWm47laCUJwg0-Rdx7pNw3dQWwuyxz?usp=sharing)], [[slides](https://distantviewing.org/tutorial/dvt_tutorial_slides_02.pdf)], [[notebook](https://github.com/distant-viewing/dvt/blob/main/tutorials/Distant_Viewing_Tutorial_2_Network_Era_Sitcoms_and_Visual_Style.ipynb)], [[chapter](https://direct.mit.edu/books/oa-monograph/chapter-pdf/2163344/c003200_9780262375160.pdf)]
A shorted demo of the toolkit is also available in the following Google Colab notebook:
- Distant Viewing Toolkit Demo: [[colab](https://colab.research.google.com/drive/1gEnx2b8EJQXijBJXGfN3-Ei5t4NBdwNJ?usp=share_link)]
Unlike the tutorials, the short demo assumes some prior knowledge of Python.
While a background in machine learning or computer vision is not needed, the
methods are presented with minimal motivation.
------------------
The Distant Viewing Toolkit is supported by the National Endowment for the Humanities through a Digital Humanities Advancement Grant.
------------------
## Citation
If you make use of the toolkit in your work, please cite the relevant papers
describing the tool and its application to the study of visual culture:
```
@article{,
title = "Distant Viewing: Analyzing Large Visual Corpora",
author = "Arnold, Taylor B and Tilton, Lauren",
journal = "Digital Scholarship in the Humanities",
year = "2019",
doi = "10.1093/digitalsh/fqz013",
url = "http://dx.doi.org/10.1093/digitalsh/fqz013"
}
```
```
@article{,
title = "Visual Style in Two Network Era Sitcoms",
author = "Arnold, Taylor B and Tilton, Lauren and Berke, Annie",
journal = "Cultural Analytics",
year = "2019",
doi = "10.22148/16.043",
url = "http://dx.doi.org/10.22148/16.043"
}
```
## Contributing
Contributions, including bug fixes and new features, to the toolkit are
welcome. When contributing to this repository, please first discuss the change
you wish to make via a GitHub issue or email with the maintainers of this
repository before making a change. Small bug fixes can be given directly
as pull requests.