chore: SCOP-7149 update linear tv related defaults (#248)

* chore: SCOP-4416 linear-tv defaults

* no au defaults

* zeroes

* fmt

* fmt

* test fix

* chore: SCOP 7149 Update linear tv defaults

* generated defaults

* fix test

* multiply pct by 100

---------

Co-authored-by: Oleksandr Halushchak <ohalushchak@scope3.com>

Author: rachitm022

defaults/docs-defaults.yaml

@@ -14,6 +14,7 @@ defaults:
     app: 140
     audio: 1500
     ctv-bvod: 2580
+    linear-tv: 2580
     social: 240
     streaming-video: 300
     web: 320
@@ -22,33 +23,37 @@ defaults:
     mobile: 1.200000000
   default_channel_by_device:
     pc:
-    - ctv-bvod
-    - social
-    - audio
-    - web
-    - streaming-video
+      - ctv-bvod
+      - social
+      - audio
+      - web
+      - streaming-video
+      - linear-tv
     phone:
-    - social
-    - ctv-bvod
-    - audio
-    - app
-    - web
-    - streaming-video
+      - social
+      - ctv-bvod
+      - audio
+      - app
+      - web
+      - streaming-video
+      - linear-tv
     smart-speaker:
-    - audio
+      - audio
     tablet:
-    - social
-    - ctv-bvod
-    - audio
-    - app
-    - web
-    - streaming-video
+      - social
+      - ctv-bvod
+      - audio
+      - app
+      - web
+      - streaming-video
+      - linear-tv
     tv:
-    - ctv-bvod
-    - social
-    - audio
-    - app
-    - streaming-video
+      - linear-tv
+      - ctv-bvod
+      - social
+      - audio
+      - app
+      - streaming-video
   default_consumer_device_request_size_bytes:
     app: 1000
     audio: 1000
@@ -62,6 +67,7 @@ defaults:
     audio: phone
     ctv-bvod: tv
     dooh: tv
+    linear-tv: tv
     social: phone
     streaming-video: pc
     web: pc
@@ -82,6 +88,13 @@ defaults:
     phone: 1920
     tablet: 2048
     tv: 1080
+  default_device_per_impression:
+    app: 1
+    audio: 1
+    ctv-bvod: 1
+    linear-tv: 0.667000000
+    streaming-video: 1
+    web: 1
   default_device_watts:
     scope3:
       pc: 53.200000000
@@ -239,11 +252,43 @@ defaults:
       YE: 11.392000000
       ZA: 30.945000000
       ZW: 33.026000000
+  default_percent_tv_distribution_method:
+    cable: 28.500000000
+    iptv: 25.200000000
+    ota: 26.200000000
+    satellite: 20
+  default_percent_tv_distribution_method_by_country:
+    AU:
+      cable: 9.200000000
+      iptv: 40.800000000
+      ota: 45.400000000
+      satellite: 4.600000000
+    DE:
+      cable: 41.600000000
+      iptv: 9.600000000
+      ota: 3.400000000
+      satellite: 45.500000000
+    FR:
+      cable: 0
+      iptv: 46
+      ota: 46
+      satellite: 8
+    GB:
+      cable: 8.900000000
+      iptv: 27.500000000
+      ota: 40.600000000
+      satellite: 23
+    US:
+      cable: 43.300000000
+      iptv: 20.700000000
+      ota: 19.200000000
+      satellite: 16.700000000
   default_platform_ad_format_by_channel:
     app: Interstitial - 1080x1920 Banner
     audio: 30s Audio
     ctv-bvod: 15s Video
     dooh: Landscape - 1920x1080 Image
+    linear-tv: 30s Video
     social: Sponsored Post - 1080x1920 Image
     streaming-video: 15s Video
     web: Leaderboard - 728x90 Banner
@@ -252,6 +297,7 @@ defaults:
     audio: 30s-audio-digital-audio-phone
     ctv-bvod: 15s-video-ctv-bvod-tv
     dooh: landscape-dooh
+    linear-tv: 30s-video-ctv-bvod-tv
     social: 1080-1920-sponsored-post-social-phone
     streaming-video: 15s-video-streaming-video-pc
     web: leaderboard-web-pc
@@ -260,13 +306,15 @@ defaults:
     audio: 100
     ctv-bvod: 100
     dooh: 100
+    linear-tv: 100
     social: 100
     streaming-video: 100
     web: 100
   default_property_average_imps_per_session_by_channel:
     app: 14
     audio: 4.800000000
     ctv-bvod: 8.256000000
+    linear-tv: 8.256000000
     social: 24
     streaming-video: 1
     web: 32
@@ -275,10 +323,27 @@ defaults:
     audio: 0.049000000
     ctv-bvod: 0.280000000
     dooh: 0.049000000
+    linear-tv: 0.280000000
     social: 0.150000000
     streaming-video: 0.049000000
     web: 0.049000000
   default_time_in_view_seconds: 6
+  default_tv_home_equipment_embodied_gco2e_per_second_by_tv_distribution_method:
+    cable: 0.010700000
+    iptv: 0.010700000
+    ota: 0.003600000
+    satellite: 0.023000000
+  default_tv_home_equipment_power_by_tv_distribution_method_watt:
+    cable: 16
+    iptv: 21
+    ota: 1
+    satellite: 22
+  default_tv_signal_preparation_power_watt: 16700
+  default_tv_signal_transmission_embodied_gco2e_per_second: 27
+  default_tv_signal_transmission_power_by_tv_distribution_method_watt:
+    cable: 16000
+    ota: 165000
+    satellite: 3150
   default_usage_kwh_per_gb:
     scope3:
       fixed: 0.030000000

docs/calculations.mdx

@@ -12,6 +12,7 @@ import TimeInViewDefaults from "/snippets/defaults_time_in_view.mdx";
 import AdPlatformDefaults from "/snippets/defaults_ad_platform.mdx";
 import NetworkTrafficDefaults from "/snippets/defaults_network_traffic.mdx";
 import ChannelMappingDefaults from "/snippets/defaults_channel_mapping.mdx";
+import BroadcastingDefaults from "/snippets/defaults_broadcasting.mdx";
 
 # Detailed walkthrough of calculations
 
@@ -226,6 +227,10 @@ Observations from various channels
 
 <ChannelMappingDefaults />
 
+### Broadcasting defaults
+
+<BroadcastingDefaults />
+
 ## Lookups from external sources
 
 ### Carbon intensity by country, region, and UTC Date/Time

docs/snippets/defaults_broadcasting.mdx

@@ -0,0 +1,56 @@
+```
+default_percent_tv_distribution_method:
+  cable: 28.5
+  iptv: 25.2
+  ota: 26.2
+  satellite: 20
+default_percent_tv_distribution_method_by_country:
+  AU:
+    cable: 9.2
+    iptv: 40.8
+    ota: 45.4
+    satellite: 4.6
+  DE:
+    cable: 41.6
+    iptv: 9.6
+    ota: 3.4
+    satellite: 45.5
+  FR:
+    cable: 0
+    iptv: 46
+    ota: 46
+    satellite: 8
+  GB:
+    cable: 8.9
+    iptv: 27.5
+    ota: 40.6
+    satellite: 23
+  US:
+    cable: 43.3
+    iptv: 20.7
+    ota: 19.2
+    satellite: 16.7
+default_tv_signal_preparation_power_watt: 16700
+default_tv_signal_transmission_power_by_tv_distribution_method_watt:
+  cable: 16000
+  ota: 165000
+  satellite: 3150
+default_tv_signal_transmission_embodied_gco2e_per_second: 27
+default_tv_home_equipment_power_by_tv_distribution_method_watt:
+  cable: 16
+  iptv: 21
+  ota: 1
+  satellite: 22
+default_tv_home_equipment_embodied_gco2e_per_second_by_tv_distribution_method:
+  cable: 0.0107
+  iptv: 0.0107
+  ota: 0.0036
+  satellite: 0.0230
+default_device_per_impression:
+  app: 1
+  audio: 1
+  ctv-bvod: 1
+  linear-tv: 0.667
+  streaming-video: 1
+  web: 1
+```

docs/snippets/defaults_channel_mapping.mdx

@@ -7,20 +7,24 @@ default_channel_by_device:
     - app
     - web
     - streaming-video
+    - linear-tv
   tablet:
     - social
     - ctv-bvod
     - audio
     - app
     - web
     - streaming-video
+    - linear-tv
   pc:
     - ctv-bvod
     - social
     - audio
     - web
     - streaming-video
+    - linear-tv
   tv:
+    - linear-tv
     - ctv-bvod
     - social
     - audio
@@ -36,6 +40,7 @@ default_device_by_channel:
   app:      phone
   web:      pc
   dooh:     tv
+  linear-tv: tv
 default_platform_ad_format_identifier_by_channel:
   dooh:            landscape-dooh
   social:          1080-1920-sponsored-post-social-phone
@@ -44,6 +49,7 @@ default_platform_ad_format_identifier_by_channel:
   audio:           30s-audio-digital-audio-phone
   app:             interstitial-app-phone
   web:             leaderboard-web-pc
+  linear-tv: 30s-video-ctv-bvod-tv
 default_platform_ad_format_by_channel:
   dooh:     Landscape - 1920x1080 Image
   social:   Sponsored Post - 1080x1920 Image
@@ -52,13 +58,15 @@ default_platform_ad_format_by_channel:
   audio:    30s Audio
   app:      Interstitial - 1080x1920 Banner
   web:      Leaderboard - 728x90 Banner
+  linear-tv: 30s Video
 default_property_average_imps_per_session_by_channel:
   social:   24
   ctv-bvod: 8.256
   streaming-video: 1
   audio:    4.8
   app:      14
   web:      32
+  linear-tv: 8.256
 default_property_ad_funded_percentage_by_channel:
   dooh:     100
   social:   100
@@ -67,13 +75,15 @@ default_property_ad_funded_percentage_by_channel:
   audio:    100
   app:      100
   web:      100
+  linear-tv: 100
 default_average_seconds_per_session_excluding_ads_by_channel:
   social:   240
   ctv-bvod: 2580
   streaming-video: 300
   audio:    1500
   app:      140
   web:      320
+  linear-tv: 2580
 default_average_data_kb_per_session_seconds_excluding_ads_by_channel:
   social:   38
   app:      29.5
@@ -86,4 +96,5 @@ default_property_g_per_imp_by_channel:
   audio:    0.049
   app:      0.049
   web:      0.049
+  linear-tv: 0.280
 ```

scope3_methodology/test/test_api.py

@@ -30,6 +30,7 @@
 TEST_NETWORKING_DEFAULTS_FILE = "defaults/networking-defaults.yaml"
 TEST_TRANSMISSION_RATE_DEFAULTS_FILE = "defaults/transmission_rate-defaults.yaml"
 TEST_DOCS_DEFAULTS_FILE = "defaults/docs-defaults.yaml"
+TEST_BROADCASTING_DEFAULTS_FILE = "defaults/broadcasting-defaults.yaml"
 
 TEST_TRANSMISSION_RATE_HIGH = TransmissionRate.load_default_yaml(
     StreamingResolution.HIGH.value,
@@ -239,7 +240,7 @@ def test_startup(self):
         )
 
         docs_defs = docs_defaults
-        self.assertEqual(len(docs_defs), 34)
+        self.assertEqual(len(docs_defs), 42)
 
     def test_get_all_con_networking_connection_device_fixed_defaults(self):
         """Test get_all_networking_connection_device_defaults returns expected output"""