سبک دادن به FeatureView

سبک ویژگی‌ها در دارایی FeatureView بااستفاده از قوانین تعریف‌شده در شیء جاوا اسکریپت مشخص می‌شود. سبک را می‌توان درطول تعریف اولیه FeatureViewLayer یا هرزمان پس‌از آن تنظیم کرد. سیستم سبک‌بندی به شما امکان می‌دهد قوانین سبک گسترده‌ای را تنظیم کنید که برای گروه‌های بزرگی از عارضه‌ها اعمال می‌شود، و همچنین قوانین خاص‌تری را برای عارضه‌های خاص تنظیم کنید. سبک عارضه را می‌توان با مقادیر ثابت یا داده‌محور، براساس مشخصه‌های عارضه، تعریف کرد.

سبک دادن به شیء

ساختار اصلی شیء سبک در زیر نشان داده شده است. دو نوع قانون وجود دارد: قوانین کلی و قوانین خاص. قوانین کلی بر همه ویژگی‌های یک دارایی FeatureView تأثیر می‌گذارند، درحالی‌که قوانین خاص بر زیرمجموعه‌ای از ویژگی‌ها تأثیر می‌گذارند.

{
  // Broad style rules.
  opacity: …,
  polygonFillColor: …,

  // Specific style rules.
  rules: [
    { … },
    { … }
  ]
};

قوانین کلی

برای اعمال ویژگی‌های سبک به همه عارضه‌ها (یا عارضه‌هایی با نوع هندسی خاص)، ویژگی‌های سبک را در سطح بالا در شیء سبک مشخص کنید.

{
  opacity: 0.5,
  pointShape: 'triangle',
  lineWidth: 10,
  polygonFillColor: 'green'
};

قوانین خاص

برای اعمال ویژگی‌های سبک به زیرمجموعه‌ای از عارضه‌ها، از فیلد rules استفاده کنید. فیلد rules فهرستی از اشیاء جاوا اسکریپت را می‌پذیرد که هرکدام دارای یک filter هستند که ویژگی‌ها را براساس شرایط تعریف‌شده توسط یک شیء ee.Filter انتخاب می‌کند، و به‌دنبال آن یک سری ویژگی‌های سبک قرار دارد. در مثال زیر، قانونی وجود دارد که polygonStrokeWidth و polygonFillColor را فقط درصورتی تنظیم می‌کند که ویژگی «REP_AREA» کمتر از ۱۰۰ باشد. قوانین خاص ویژگی‌های سبک قوانین کلی را لغو می‌کنند و قوانین نزدیک به انتهای فهرست rules قوانین نزدیک به ابتدا را لغو می‌کنند (قوانین خاص از اول به آخر ارزیابی می‌شوند).

{
  rules: [
    {
      filter: ee.Filter.lt('REP_AREA', 100),
      polygonStrokeWidth: 0.5,
      polygonFillColor: 'blue'
    },
    { … }  // Optionally include additional rules.
  ]
};

تنظیم سبک

سبک عارضه را می‌توان هنگام اعلام FeatureViewLayer یا هرزمان پس‌از آن تنظیم کرد.

FeatureViewLayer اظهارنامه

برای تنظیم پارامترهای دیداری‌سازی هنگام اعلام FeatureViewLayer، از پارامتر visParams استفاده کنید.

var visParams = {
  opacity: 0.5,
  lineWidth: 10,
  polygonFillColor: 'purple'
};

var layer = ui.Map.FeatureViewLayer({
  assetId: 'WCMC/WDPA/current/polygons_FeatureView',
  visParams: visParams
});

Map.add(layer);

FeatureViewLayer موجود

برای تنظیم پارامترهای تجسم برای FeatureViewLayer موجود، از تابع setVisParams استفاده کنید. این کار جایگزین هرگونه قانون سبک مشخص‌شده قبلی می‌شود؛ ویژگی‌های نامشخص روی پیش‌فرض تنظیم می‌شوند.

var layer = ui.Map.FeatureViewLayer('WCMC/WDPA/current/polygons_FeatureView');
Map.add(layer);

layer.setVisParams({
  opacity: 0.5,
  lineWidth: 10,
  polygonFillColor: 'purple'
});

نمادشناسی

برای هر ویژگی سبک، می‌توانید قانون سبک ثابت یا قانون سبک داده‌محور مشخص کنید. گزینه داده‌محور از مقادیر ویژگی عارضه برای تعیین نمادگذاری استفاده می‌کند که می‌تواند طبقه‌بندی‌شده یا درون‌یابی‌شده باشد. برای مشاهده فهرست کامل ویژگی‌های سبک، به جدول ویژگی‌های سبک مراجعه کنید.

ثابت

قانون سبک ثابت شامل یک ویژگی سبک برای تنظیم و مقدار آن است. مثال زیر رنگ پرکننده چندضلعی را روی آبی تنظیم می‌کند.

var visParams = {
  polygonFillColor: 'blue'
};

دسته‌بندی‌شده

یک قانون سبک طبقه‌بندی‌شده شامل یک ویژگی سبک برای تنظیم و یک شیء جاوا اسکریپت با سه ویژگی است:

  • property — نام ویژگی عارضه که مقدار آن بر سبک تأثیر می‌گذارد.
  • categories — فهرستی از فهرست‌ها که مقادیر ویژگی عارضه را به نمادشناسی‌های ویژگی سبک نگاشت می‌کند. هر دسته شامل یک مقدار ویژگی است که به‌دنبال آن یک مقدار نمادشناسی برای اعمال وجود دارد. مقدار ویژگی که دسته‌ای را تعریف می‌کند باید رشته باشد.
  • defaultValue — نمادشناسی پیش‌فرضی که برای ویژگی‌هایی اعمال می‌شود که مقدار دارایی آن‌ها در categories تعریف نشده است. اگر تهی/ تعریف‌نشده باشد، تنظیمات سبک پیش‌فرض اعمال خواهد شد.

برای مثال، شیء زیر خصوصیت سبک color را براساس خصوصیت عارضه «MARINE» تنظیم می‌کند. عوارض در دسته «دریایی» «۰» به‌صورت بنفش، «۱» به‌صورت سبز، «۲» به‌صورت آبی، و هر دسته دیگری به‌صورت سفید تنظیم شده است.

var visParams = {
  color: {
    property: 'MARINE',
    categories: [
      ['0', 'purple'],
      ['1', 'green'],
      ['2', 'blue']
    ],
    defaultValue: 'white'
  }
};

درون‌یابی‌شده

قانون سبک درون‌یابی‌شده شامل یک ویژگی سبک برای تنظیم و یک شیء جاوا اسکریپت با حداکثر پنج ویژگی است:

  • property — نام ویژگی عارضه که مقدار آن بر سبک تأثیر می‌گذارد.
  • mode — حالت درون‌یابی، 'linear' یا 'interval'.
  • palette — فهرستی از رنگ‌ها، میزان‌های شفافیت، یا پهناهایی که مقادیر ویژگی ورودی بین آن‌ها درون‌یابی می‌شود. قالب به mode بستگی دارد، برای جزئیات بیشتر، بخش‌های خطی و فاصله را ببینید.

فقط برای حالت 'linear' اعمال می‌شود

  • min — مقدار ویژگی برای نگاشت به اولین عنصر در فهرست palette.
  • max — مقدار خصوصیت برای نگاشت به آخرین عنصر در فهرست palette.

خطی

حالت درون‌یابی خطی با نگاشت مقادیر ورودی در محدوده min تا max به‌صورت خطی بین فهرستی از مقادیر نمادشناسی تعریف‌شده در ویژگی palette، ویژگی سبک عارضه را تنظیم می‌کند. مقادیر ورودی به محدوده تنظیم‌شده توسط min و max محدود می‌شوند.

برای مثال، شیء زیر ویژگی سبک color را براساس ویژگی عارضه «REP_AREA» تنظیم می‌کند. ویژگی palette فهرستی از رنگ‌ها است که نشان می‌دهد مقادیر ورودی بین min و max باید به‌صورت خطی از زرد به قرمز و سپس به آبی درجه‌بندی شوند. مقداری بین ۱ و ۵۰۰ بین زرد و قرمز درون‌یابی می‌شود، و مقداری بین ۵۰۰ و ۱۰۰۰ بین قرمز و آبی درون‌یابی می‌شود.

var visParams = {
  color: {
    property: 'REP_AREA',
    mode: 'linear',
    palette: ['yellow', 'red', 'blue'],
    min: 1,
    max: 1000
  }
};

فاصله

حالت درون‌یابی فاصله‌ای با نگاشت مقادیر ورودی به شکست‌های کلاس و سپس اعمال نمادشناسی مختص کلاس، ویژگی سبک عارضه را تنظیم می‌کند. مقادیر ورودی از ویژگی عارضه انتخاب‌شده با گرد کردن به پایین به نزدیک‌ترین مقدار شکست کلاس اختصاص داده می‌شود. ویژگی palette به‌صورت فهرستی از فهرست‌ها قالب‌بندی می‌شود، که هر فهرست داخلی حاوی یک مقدار شکست کلاس و به‌دنبال آن یک مقدار ویژگی سبک است. ویژگی‌هایی که مقدار مشخصه آن‌ها کمتر از حداقل مقدار شکست کلاس است، تنظیمات مشخصه سبک پیش‌فرض خود را حفظ می‌کنند.

در مثال زیر، ماتی پر کردن عارضه براساس کلاس‌های درجه‌بندی‌شده ویژگی «REP_AREA» تنظیم شده است. تعریف کلاس و نمادشناسی سبک در ویژگی palette به‌صورت فهرستی از فهرست‌ها ارائه می‌شود. این نشان می‌دهد که باید ۴ کلاس با شکستگی در مقادیر ۰، ۸۰، ۲۰۰۰، و ۵۰۰۰ وجود داشته باشد، با کدری‌های ویژگی مربوطه ۰٫۵، ۰٫۳۵، ۰٫۲۲، و ۰٫۱۵. In other words, features with "REP_AREA" values in the interval $ 0 \le x < 80 $ will have a fill opacity of 0.5, values in the interval $ 80 \le x < 2000 $ will have fill opacity of 0.35, and so on.

var visParams = {
  fillOpacity: {
    property: 'REP_AREA',
    mode: 'interval',
    palette: [
      [0, 0.5],
      [80, 0.35],
      [2000, 0.22],
      [5000, 0.15]
    ]
  }
};

همه ویژگی‌های سبک

در زیر همه ویژگی‌های سبکی که می‌توانید در شیء سبک مشخص کنید آورده شده است. تنظیم کردن ویژگی‌های سبک برای انواع هندسه خاص، ویژگی‌های سبک مربوطه را که برای «همه هندسه‌ها» تنظیم شده است لغو می‌کند (برای مثال، تنظیم کردن polygonFillColor مقدار تنظیم‌شده در fillColor را لغو می‌کند).

دارایی نوع شرح از قانون درون‌یابی‌شده پشتیبانی می‌کند
همه هندسه‌ها
isVisible Boolean تنظیم می‌کند که ویژگی نمایان باشد یا نه. نه
color String رنگ پر کردن/قلم‌زنی را برای همه انواع هندسه تنظیم می‌کند. باید مقداری بر مبنای شانزده یا رنگ CSS3 باشد. بله
opacity Double ماتی پر کردن/قلم‌زنی را برای همه انواع هندسه تنظیم می‌کند. باید عددی با دقت مضاعف بین ۰ و ۱ باشد. بله
width Double عرض خط را برای همه انواع هندسه تنظیم می‌کند. بله
fillColor String رنگ پرکننده را برای همه انواع هندسه تنظیم می‌کند. باید مقداری بر مبنای شانزده یا رنگ CSS3 باشد. بله
هندسه‌های نقطه‌ای
pointShape String شکل هندسه‌های نقطه‌ای را تنظیم می‌کند. از همان شکل‌های ee.FeatureCollection.style پشتیبانی می‌کند (دایره، مربع، لوزی، صلیب، علامت جمع، ستاره پنج‌پر، ستاره شش‌پر، مثلث، مثلث رو به بالا، مثلث رو به پایین، مثلث رو به چپ، مثلث رو به راست، پنج‌ضلعی، شش‌ضلعی، ستاره پنج‌پر، ستاره شش‌پر). نه
pointSize Double عرض هندسه‌های نقطه‌ای را (به پیکسل) تنظیم می‌کند. بله
pointFillColor String رنگ پرکننده را برای هندسه‌های نقطه‌ای تنظیم می‌کند. باید مقداری بر مبنای شانزده یا رنگ CSS3 باشد. بله
pointFillOpacity Double ماتی پرکننده را برای هندسه‌های نقطه‌ای تنظیم می‌کند. باید عددی با دقت مضاعف بین ۰ و ۱ باشد. بله
هندسه خط
lineType String نوع خط را تنظیم می‌کند. از همان انواع ee.FeatureCollection.style (توپر، خط‌چین، نقطه‌چین) پشتیبانی می‌کند. نه
lineWidth Double عرض خط را (به پیکسل) تنظیم می‌کند. بله
lineColor String رنگ را برای هندسه‌های خطی تنظیم می‌کند. باید مقداری بر مبنای شانزده یا رنگ CSS3 باشد. بله
lineOpacity Double ماتی را برای هندسه‌های خطی تنظیم می‌کند. باید عددی با دقت مضاعف بین ۰ و ۱ باشد. بله
هندسه‌های چندضلعی
polygonStrokeWidth Double ضخامت خط پیرامونی چندضلعی‌ها را (به پیکسل) تنظیم می‌کند. بله
polygonStrokeType String نوع خط را برای چندضلعی‌ها تنظیم می‌کند. از همان انواع ee.FeatureCollection.style (توپر، خط‌چین، نقطه‌چین) پشتیبانی می‌کند. نه
polygonStrokeColor String رنگ خط را برای هندسه‌های چندضلعی تنظیم می‌کند. باید مقداری بر مبنای شانزده یا رنگ CSS3 باشد. بله
polygonStrokeOpacity Double ماتی ضربه قلم را برای هندسه‌های چندضلعی تنظیم می‌کند. باید عددی اعشاری با دقت مضاعف بین ۰ و ۱ باشد. بله
polygonFillColor String رنگ پرکننده را برای هندسه‌های چندضلعی تنظیم می‌کند. باید مقداری بر مبنای شانزده یا رنگ CSS3 باشد. بله
polygonFillOpacity Double ماتی پرکننده را برای هندسه‌های چندضلعی تنظیم می‌کند. باید عددی اعشاری با دقت مضاعف بین ۰ و ۱ باشد. بله