공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
ee.FeatureCollection.randomColumn
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
확정적인 가우스 숫자의 열을 컬렉션에 추가합니다. 출력은 배정밀도 부동 소수점 수입니다. '균일' 분포 (기본값)를 사용하는 경우 출력은 [0, 1) 범위입니다. '정규' 분포를 사용하면 출력의 μ=0, σ=1이지만 명시적인 제한은 없습니다.
사용 | 반환 값 |
---|
FeatureCollection.randomColumn(columnName, seed, distribution, rowKeys) | FeatureCollection |
인수 | 유형 | 세부정보 |
---|
this: collection | FeatureCollection | 임의의 열을 추가할 입력 컬렉션입니다. |
columnName | 문자열, 기본값: 'random' | 추가할 열의 이름입니다. |
seed | 긴, 기본값: 0 | 랜덤 숫자를 생성할 때 사용되는 시드입니다. |
distribution | 문자열, 기본값: 'uniform' | 생성할 난수의 분포 유형입니다. '균일' 또는 '정규' 중 하나입니다. |
rowKeys | 목록(선택사항) | 컬렉션의 요소를 고유하고 반복적으로 식별해야 하는 속성 목록으로, 랜덤 숫자를 생성하는 데 사용됩니다. 기본값은 [system:index]입니다. |
예
코드 편집기 (JavaScript)
// FeatureCollection of power plants in Belgium.
var fc = ee.FeatureCollection('WRI/GPPD/power_plants')
.filter('country_lg == "Belgium"');
print('N features in collection', fc.size());
// Add a uniform distribution random value column to the FeatureCollection.
fc = fc.randomColumn();
// Randomly split the collection into two sets, 30% and 70% of the total.
var randomSample30 = fc.filter('random < 0.3');
print('N features in 30% sample', randomSample30.size());
var randomSample70 = fc.filter('random >= 0.3');
print('N features in 70% sample', randomSample70.size());
Python 설정
Python API 및 대화형 개발을 위한 geemap
사용에 관한 자세한 내용은
Python 환경 페이지를 참고하세요.
import ee
import geemap.core as geemap
Colab (Python)
# FeatureCollection of power plants in Belgium.
fc = ee.FeatureCollection('WRI/GPPD/power_plants').filter(
'country_lg == "Belgium"')
print('N features in collection:', fc.size().getInfo())
# Add a uniform distribution random value column to the FeatureCollection.
fc = fc.randomColumn()
# Randomly split the collection into two sets, 30% and 70% of the total.
random_sample_30 = fc.filter('random < 0.3')
print('N features in 30% sample:', random_sample_30.size().getInfo())
random_sample_70 = fc.filter('random >= 0.3')
print('N features in 70% sample:', random_sample_70.size().getInfo())
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003e\u003ccode\u003erandomColumn()\u003c/code\u003e adds a new column of pseudorandom numbers to a FeatureCollection, with the default column name being "random".\u003c/p\u003e\n"],["\u003cp\u003eThe generated random numbers can follow either a uniform distribution ([0, 1)) or a normal distribution (μ=0, σ=1) specified using the \u003ccode\u003edistribution\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eUsers can provide a seed value for reproducibility using the \u003ccode\u003eseed\u003c/code\u003e parameter, ensuring the same sequence of random numbers is generated for a given seed.\u003c/p\u003e\n"],["\u003cp\u003eThis function is commonly used for tasks like randomly splitting a FeatureCollection into subsets for training and testing machine learning models, as demonstrated in the examples.\u003c/p\u003e\n"]]],["This tool adds a column of pseudorandom numbers to a FeatureCollection. Users can specify the `columnName`, `seed`, and `distribution`. The default distribution, 'uniform', generates numbers between 0 and 1; 'normal' produces numbers with a mean of 0 and a standard deviation of 1. The `randomColumn` method returns the modified FeatureCollection. This is exemplified by creating random splits into subsets. The outputs are double-precision floating point numbers.\n"],null,["# ee.FeatureCollection.randomColumn\n\nAdds a column of deterministic pseudorandom numbers to a collection. The outputs are double-precision floating point numbers. When using the 'uniform' distribution (default), outputs are in the range of \\[0, 1). Using the 'normal' distribution, outputs have μ=0, σ=1, but have no explicit limits.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------------------------------------------------------------------------------|-------------------|\n| FeatureCollection.randomColumn`(`*columnName* `, `*seed* `, `*distribution* `, `*rowKeys*`)` | FeatureCollection |\n\n| Argument | Type | Details |\n|--------------------|----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `collection` | FeatureCollection | The input collection to which to add a random column. |\n| `columnName` | String, default: \"random\" | The name of the column to add. |\n| `seed` | Long, default: 0 | A seed used when generating the random numbers. |\n| `distribution` | String, default: \"uniform\" | The distribution type of random numbers to produce; one of 'uniform' or 'normal'. |\n| `rowKeys` | List, optional | A list of properties that should uniquely and repeatably identify an element of the collection, used to generate the random number. Defaults to \\[system:index\\]. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// FeatureCollection of power plants in Belgium.\nvar fc = ee.FeatureCollection('WRI/GPPD/power_plants')\n .filter('country_lg == \"Belgium\"');\nprint('N features in collection', fc.size());\n\n// Add a uniform distribution random value column to the FeatureCollection.\nfc = fc.randomColumn();\n\n// Randomly split the collection into two sets, 30% and 70% of the total.\nvar randomSample30 = fc.filter('random \u003c 0.3');\nprint('N features in 30% sample', randomSample30.size());\n\nvar randomSample70 = fc.filter('random \u003e= 0.3');\nprint('N features in 70% sample', randomSample70.size());\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# FeatureCollection of power plants in Belgium.\nfc = ee.FeatureCollection('WRI/GPPD/power_plants').filter(\n 'country_lg == \"Belgium\"')\nprint('N features in collection:', fc.size().getInfo())\n\n# Add a uniform distribution random value column to the FeatureCollection.\nfc = fc.randomColumn()\n\n# Randomly split the collection into two sets, 30% and 70% of the total.\nrandom_sample_30 = fc.filter('random \u003c 0.3')\nprint('N features in 30% sample:', random_sample_30.size().getInfo())\n\nrandom_sample_70 = fc.filter('random \u003e= 0.3')\nprint('N features in 70% sample:', random_sample_70.size().getInfo())\n```"]]