fathomnet-py

An open-source image database that can be used to train, test, and validate state-of-the-art artificial intelligence algorithms to help us understand our ocean and its inhabitants.
https://github.com/fathomnet/fathomnet-py

Category: Biosphere
Sub Category: Marine Life and Fishery

Keywords from Contributors

profiles weather-station

Last synced: about 24 hours ago
JSON representation

Repository metadata

FathomNet Python client

• Host: GitHub
• URL: https://github.com/fathomnet/fathomnet-py
• Owner: fathomnet
• License: mit
• Created: 2021-08-23T21:23:31.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2025-04-09T06:05:59.000Z (9 months ago)
• Last Synced: 2025-11-21T12:03:54.296Z (about 1 month ago)
• Language: Python
• Homepage: https://fathomnet-py.readthedocs.io
• Size: 337 KB
• Stars: 34
• Watchers: 4
• Forks: 4
• Open Issues: 5
• Releases: 19
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Citation: CITATION.cff

README.md

>>> from fathomnet.api import boundingboxes
>>> boundingboxes.find_concepts()
['2G Robotics structured light laser', '55-gallon drum', ...]
>>> from fathomnet.api import images
>>> images.find_by_concept('Nanomia')
[
    AImageDTO(
        id=2274942, 
        uuid='cdbfca66-284f-48ac-a36f-7b2ac2b43533', 
        url='https://database.fathomnet.org/static/m3/framegrabs/MiniROV/images/0056/02_18_37_20.png', 
        ...
    ),
    ...
]
>>> from fathomnet.api import taxa
>>> taxa.find_children('mbari', 'Bathochordaeus')
[
    Taxa(name='Bathochordaeus stygius', rank='species'), 
    Taxa(name='Bathochordaeus charon', rank='species'), 
    Taxa(name='Bathochordaeus mcnutti', rank='species')
]
>>> from fathomnet.api import xapikey
>>> xapikey.auth('NuCLjlNUlgHchtgDB01Sp1fABJVcWR')  # your API key here
AuthHeader(
    type='Bearer', 
    token='eyJhbGciOiJI...'
)

$ python -m pip install fathomnet

Citation (CITATION.cff)

cff-version: 1.2.0
title: "fathomnet-py"
authors:
  - family-names: Barnard
    given-names: Kevin
type: software
message: "If you use this software, please cite both the article from preferred-citation and the software itself."
preferred-citation:
  type: article
  authors:
    - family-names: Katija
      given-names: Kakani
    - family-names: Orenstein
      given-names: Eric
    - family-names: Schlining
      given-names: Brian
    - family-names: Lundsten
      given-names: Lonny
    - family-names: Barnard
      given-names: Kevin
    - family-names: Sainz
      given-names: Giovanna
    - family-names: Boulais
      given-names: Oceane
    - family-names: Cromwell
      given-names: Megan
    - family-names: Butler
      given-names: Erin
    - family-names: Woodward
      given-names: Benjamin
    - family-names: Bell
      given-names: Katherine L. C.
  title: "FathomNet: A global image database for enabling artificial intelligence in the ocean"
  journal: "Scientific Reports"
  volume: "12"
  issue: "1"
  year: 2022
  date-released: "2022-09-23"
  pages: "15914"
  doi: "10.1038/s41598-022-19939-2"
  url: "https://doi.org/10.1038/s41598-022-19939-2"

Owner metadata

• Name: FathomNet
• Login: fathomnet
• Email:
• Kind: organization
• Description: FathomNet is an open-source image database that can be used to train machine learning algorithms to help us understand our ocean and its inhabitants
• Website: www.fathomnet.org
• Location: United States of America
• Twitter: fathomnet
• Company:
• Icon url: https://avatars.githubusercontent.com/u/77417933?v=4
• Repositories: 4
• Last ynced at: 2023-03-11T08:36:28.350Z
• Profile URL: https://github.com/fathomnet

GitHub Events

Total

• Create event: 6
• Issues event: 4
• Release event: 5
• Watch event: 7
• Issue comment event: 2
• Push event: 26
• Fork event: 1

Last Year

• Create event: 3
• Issues event: 4
• Release event: 3
• Watch event: 2
• Issue comment event: 2
• Push event: 15

Committers metadata

Last synced: 2 days ago

Committer domains:

• mbari.org: 3
• ucsd.edu: 1
• github.com: 1

Issue and Pull Request metadata

Last synced: 16 days ago

Package metadata

• Total packages: 2
• Total downloads:
  • pypi: 563 last-month
• Total dependent packages: 0 (may contain duplicates)
• Total dependent repositories: 1 (may contain duplicates)
• Total versions: 70
• Total maintainers: 1

Dependencies

Score: 11.946297526331401