[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2023-10-06 UTC."],[[["\u003cp\u003e\u003ccode\u003etoList\u003c/code\u003e retrieves elements from an ImageCollection and returns them as a List.\u003c/p\u003e\n"],["\u003cp\u003eIt allows you to specify the maximum number of elements to fetch using the \u003ccode\u003ecount\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eYou can control the starting position for element retrieval with the optional \u003ccode\u003eoffset\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eIt's important to note that \u003ccode\u003etoList\u003c/code\u003e can be resource-intensive for large collections, potentially leading to memory limitations.\u003c/p\u003e\n"]]],["The function `ImageCollection.toList()` converts a collection's elements into a list. It takes a `count` argument, specifying the maximum number of elements to include. An optional `offset` argument allows discarding a set number of elements from the beginning. For example, setting a count of 3 and an offset of 3 returns elements four, five and six. The function is used with the input `collection`, a `FeatureCollection`. This process potentially demands significant resources, particularly with large collections.\n"],null,["# ee.ImageCollection.toList\n\nReturns the elements of a collection as a list.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------------------------|---------|\n| ImageCollection.toList`(count, `*offset*`)` | List |\n\n| Argument | Type | Details |\n|--------------------|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `collection` | FeatureCollection | The input collection to fetch. |\n| `count` | Integer | The maximum number of elements to fetch. |\n| `offset` | Integer, default: 0 | The number of elements to discard from the start. If set, (offset + count) elements will be fetched and the first offset elements will be discarded. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Note: ee.ImageCollection.toList may take a lot of time and memory to run,\n// since it must generate all of the results in order to gather them into a\n// list. Large collections and/or complex computations can produce memory\n// limitation errors.\n\n// A Landsat 8 TOA image collection (1 year of images at a specific point).\nvar col = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA')\n .filterBounds(ee.Geometry.Point(-90.70, 34.71))\n .filterDate('2020-01-01', '2021-01-01');\nprint('Image collection', col);\n\n// Get the first 3 images as a list of images.\nvar imgListFirst3 = col.toList(3);\nprint('First 3 images', imgListFirst3);\n\n// Get the second 3 images as a list of images (use the offset parameter).\nvar imgListSecond3 = col.toList(3, 3);\nprint('Second 3 images', imgListSecond3);\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# Note: ee.ImageCollection.toList may take a lot of time and memory to run,\n# since it must generate all of the results in order to gather them into a\n# list. Large collections and/or complex computations can produce memory\n# limitation errors.\n\n# A Landsat 8 TOA image collection (1 year of images at a specific point).\ncol = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA').filterBounds(\n ee.Geometry.Point(-90.70, 34.71)).filterDate('2020-01-01', '2021-01-01')\nprint('Image collection:', col.getInfo())\n\n# Get the first 3 images as a list of images.\nimg_list_first3 = col.toList(3)\nprint('First 3 images:', img_list_first3.getInfo())\n\n# Get the second 3 images as a list of images (use the offset parameter).\nimg_list_second3 = col.toList(3, 3)\nprint('Second 3 images:', img_list_second3.getInfo())\n```"]]
