Warning, /documentation/digikam-doc/export_tools/inaturalist_export.rst is written in an unsupported language. File is not indexed.
0001 .. meta:: 0002 :description: digiKam Export to iNaturalist Web-Service 0003 :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, inaturalist, export 0004 0005 .. metadata-placeholder 0006 0007 :authors: - digiKam Team 0008 0009 :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html) 0010 0011 .. _inaturalist_export: 0012 0013 Export To iNaturalist 0014 ===================== 0015 0016 .. contents:: 0017 0018 `iNaturalist <https://en.wikipedia.org/wiki/INaturalist>`_ is a social network of naturalists, citizen scientists, and biologists built on the concept of mapping and sharing observations of biodiversity across the globe. iNaturalist users contribute to share observations of plants, animals, fungi, and other organisms worldwide. 0019 0020 The iNaturalist platform is based on crowd-sourcing of observations and identifications. An iNaturalist **observation** records a person's encounter with an individual organism at a particular time and place. 0021 0022 To upload observation shots from your collections to the remote iNaturalist server using the Internet, uses the :menuselection:`Export --> Export to iNaturalist` :kbd:`Ctrl+Alt+Shift+N` menu entry, or the corresponding icon from the **Tools** tab in Right Sidebar. 0023 0024 .. important:: 0025 0026 To push an **observation** to iNaturalist repository, shots must be geo-localized, taken in same conditions, separated by a brief delay, and surrounding the same subject. A description of observation must be provided, including the main topic. 0027 0028 When you launch the tool, the following dialog will popup to select the account to use with the web-service. 0029 0030 .. figure:: images/export_inaturalist_account.webp 0031 :alt: 0032 :align: center 0033 0034 The iNaturalist Export Dialog 0035 0036 If no account previously used is available, press **Add another account** button and a web-browser instance will be started with the iNaturalist login page. 0037 0038 .. figure:: images/export_inaturalist_login.webp 0039 :alt: 0040 :align: center 0041 0042 The iNaturalist Web Page to Login in Your Account 0043 0044 Fill the account and password properties and validate the settings to continue to the main tool dialog: 0045 0046 .. figure:: images/export_inaturalist_dialog.webp 0047 :alt: 0048 :align: center 0049 0050 The iNaturalist Export Dialog 0051 0052 On the right side, you can see the settings view to use to upload observation shots on the iNaturalist server. Even if you can use the basic settings to process files, we recommend to expand the settings with the **Fewer options** button, to tune precisely the observation properties. 0053 0054 On the top of the settings view, you can see the login **Account** properties used to be connected to iNaturalist. You can switch to another account using the **Change Account** button. The **Remove Account** button will allows to delete cached information by the tool to be connected automatically on the server in later session. 0055 0056 On the bottom of the settings view, you can set the upload **Options** for the images. If the **Resize photos before uploading** option is selected, the photos will be resized before transferring to iNaturalist. The values will be read from the **JPEG quality** and **Maximum Dimension** settings, which can be used to adjust the maximum height and the compression. The width calculation will be done so as to have the aspect ratio conserved. 0057 0058 A special option is available to **Write the photo ID to the source image**. The identification number used to upload to your iNaturalist account will be recorded in the XMP metadata from file in your collection. 0059 0060 On the middle of the settings view, you can tune the **Observation** properties. The most important one is to identify the subject using the iNaturalist database by entering words in **Identification** text field. The tool will query the remote server to search the best entries with a preview. If one item matches with the observation subject, just select it. 0061 0062 .. figure:: images/export_inaturalist_search.webp 0063 :alt: 0064 :align: center 0065 0066 The iNaturalist Export Tool Searching About Contents on Online Database 0067 0068 The **Place** text property will help iNaturalist database to identify in human way where the observation have been done, outside the fact that photos have been geo-localized with a GPS. 0069 0070 On the left side, you can see the list of observation shots taken from digiKam collection. From the **Date** column, the tool scans the items to found the most older one as reference, and computes the delay of all other shots compared to this one. The maximum delay between the reference and the most recent shot must be lesser than value set in the **Photos should be taken within** from the settings view. 0071 0072 In the same way, the tool scan also the items to found the original place of observation using the reference image. It computes the distance of all other shots compared to this one. The maximum meters between the reference and the most recent shot must be lesser than value set in the **Photos should be taken within** from the settings view. 0073 0074 Press **Start Uploading** button to transfer items. You can click on the **Close** button to abort the uploading of photos. 0075 0076 Finally, you can view the uploaded photos by visiting the iNaturalist website. 0077 0078 .. figure:: images/export_inaturalist_stream.webp 0079 :alt: 0080 :align: center 0081 0082 The iNaturalist Online Account Displaying the Observed Publications