SÜRÜ 2022

Sürü 2022 yarışması, Pekiştirmeli Öğrenme için geliştirilen strateji oyunu simülasyonunda, yarışmacıların eğittikleri yapay zekaların birbirleriyle ve referans botu ile çarpıştırılmasıyla gerçekleştirilecektir. Oyunun haritaları altıgen ızgara dünyası ile temsil edilmektedir. Haritalar farklı boyutlara, arazilere, kaynaklara, başlangıç üniteleri ve başlangıç konumlarına sahiptir. Harita tasarımı geliştirici veya oyuncu tarafından hızlıca ve kolayca yapılabilmektedir. Oyundaki tarafların amacı, belirlenen tur sayısının sonunda rakipten daha fazla kaynağa sahip olmaktır. Oyun başında taraflar az miktarda kaynakla başlarlar ve haritada bulunan kaynakları toplamaya çalışırlar.

Nasıl Kurulur?

Aşağıdaki Drive linki yardımıyla yarışma ortamının repository'sine ulaşabilirsiniz.

https://drive.google.com/drive/folders/1iW29h7h37fBCvevWBUEYlUWR1Pe2ec1v?usp=sharing

Yarışma ortamı, yani strateji oyunu simülasyonu, Linux tabanlı bilgisayarlar için geliştirilmiştir ve diğer işletim sistemlerinde çalışmamakta ya da düşük performans ile çalışmaktadır. Bu durumun bir sıkıntıya yol açmaması için ana dizindeki `dockerfile` dosyası yardımıyla bir Docker konteynırı oluşturmanızı ve dosyaları Docker konteynırı yardımıyla kullanmanızı öneriyoruz. Eğer bahsedilen `dockerfile` dosyasını kullanmamayı tercih ediyorsanız bu dosyanın içinde bulunan özellikle Python, TensorFlow ve PyTorch olmak üzere bütün kütüphanelerin doğru versiyonlarının kurulduğundan emin olmanız gerekmektedir. Bütün bu gereksinimler yüklendiğinde kodlar kullanıma hazır hale gelmektedir.

Nasıl Çalıştırılır?

`python src/egitimkodu.py "harita" "mavi_takım" "kırmızı_takım"`

Yukarıdaki satır, terminal ekranı yardımıyla oyunun çalıştırılması için gereken argümanları ifade etmektedir. Burada `src/egitimkodu.py` src klasöründeki eğitim kodu dosyasını, `harita` data/config klasörü içindeki haritalardan hangisinin seçileceğini, `mavi_takım` ve `kırmızı_takım` ise karşılıklı çarpıştırılacak botları veya yapay zekaları temsil etmektedir. Örnek eğitim kodları; mavi takım eğitilen yapay zekayı, kırmızı takım ise rakibi temsil edecek şekilde oluşturulmuştur.

Örnek kullanım: `python src/agentsofglory.py ResourceRiver SimpleAgent RandomAgent`

`agentsofglory.py` yerine Stable-baselines3 eğitim örneği için `sb3cadet.py` veya RlLib-Ray eğitim örneği için `traincadet.py` dosyasını kullanabilirsiniz.

• Yarışmacılara sağlanacak tüm yazılımlar ve veriler y3portal.ssyz.org.tr alanında tanımlı portal üzerinden yarışmacı hesapları ile paylaşılacaktır.
• Yarışmacılar ile karma sürü angajman ortamı yazılımı, simülatör görselleştirme ara yüzü, örnek eğitim haritaları, harita editörü, örnek algoritma eğitme şemaları ve kendi algoritmalarını eğitebilmeleri için hazır düşman algoritmaları (botlar) paylaşılacaktır. Paylaşılacak tüm yazılımlarda Python programlama dili kullanılacaktır.
• Yarışmacılar geliştirmiş oldukları algoritmalar ve yazılımları y3portal.ssyz.org.tr yarışma portalına istenen formatta yükleyeceklerdir. Algoritmanın ve yazılımların nasıl yükleneceği ve format isterleri yarışmacılar ile detaylı şekilde paylaşılacaktır.
• Algoritma yükleyen yarışmacılar arasında bir lig (lider tablosu) oluşturulacaktır. Ligdeki algoritmalar eğitim setinde yer almayan haritalarda, eğitim setinde yer almayan botlara karşı savaşacaktır. Ligi ilk 4 sırada bitiren ekipler arasında bir turnuva yapılacak ve yarışmanın sonucunun bu turnuva belirleyecektir.
• Turnuva karşılaşmalarının simülatör görselleştirme ara yüzü üzerinden canlı yayınlanacağı bir çevrimiçi etkinlik düzenlenecektir.

1. Teslim edilen algoritmaların ve yazılımların yarışma formatındaki herhangi bir harita için, her bir ayrık zaman adımında, gözlenen senaryo durumunu girdi olarak alıp, yönettiği sürü için o zaman adımına ait aksiyonları çıktı olarak vermesi gerekmektedir
2. Sürülerdeki üniteler değişik kaynak toplama ve saldırı kabiliyetlere sahip hava ve kara araçlarından oluşacaktır. Geliştirilecek algoritmaların sabit olmayan sayıda üniteyi kontrol edebilmesi gerekmektedir.
3. Yarışma için kurulacak ligde (liderlik tablosu), yarışmacılar eğitim setinde bulunmayan haritalarda botlara karşı savaşacaklardır. Yarışmacıların botlara karşı olan performansına göre liderlik tablosu güncellenecektir.
4. Karşılaşmaların amacı haritadaki en fazla kaynağı toplamak üzerinedir. Belirli bir zaman limiti sonrasında en fazla kaynağı toplamış olan ekip karşılaşmayı kazanmış olarak kabul edilecektir.
5. Sürülerdeki ünitelerin birbirlerine saldırma ve imha etme opsiyonuna sahiptir. Bu şekilde yarışmacıları birbirlerinin ünitelerine saldırıp birbirlerinin kaynak toplama yeteneğini kısıtlama imkanına sahiptir.
6. Algoritmalar değişken sayıda üniteyi aynı anda kontrol edecektir. Yarışmacılar belli zaman ve kaynak kısıtları dahilinde yeni üniteler üretebilecektir.
7. Karşılaşmayı kazanan takım 1 (bir), kaybeden takım ise sıfır (0) puan alacaktır.
8. Yarışma ortamı belirsizlik içeren öğelere sahip olacaktır. Örneğin yönetilen bir birimin saldırdığı birimi yok etmesi olasılıksal bir süreç olarak modellenecektir. Bu yüzden karşılaştırmaların adil olması için her ikili karşılaşma en az 30 kez gerçekleştirilip, takımlara bu karşılaşmaların ortalaması kadar puan verilecektir. Örneğin 30 karşılaşmanın 12’sini A Ekibi, 18’ini B Ekibinin kazanması durumunda, A Ekibi 12/30= 0.4 puan, B ekibi ise 18/30=0.6 puan kazanacaktır.
9. Ligde botlara karşı bütün ikili karşılaşmalar yukarıda ifade edildiği şekilde gerçekleştirildikten sonra ortaya çıkan puan sıralaması turnuvaya katılmaya hak kazanan 4 takımı belirleyecektir.
10. Turnuvada iki yarı final, bir final ve bir üçüncülük karşılaşması olmak üzere toplam 4 karşılaşma gerçekleşecektir. Turnuvada yarışmacıların algoritmaları botlara karşı değil birbirlerine karşı savaşacaklardır. Bu karşılaşmanın kazananları yarışmada dereceye girenleri belirleyecektir.
11. Yarışmacıların algoritmalara ek olarak yaklaşımlarını anlatan teknik raporlar da teslim etmesi gerekmektedir. Fakat bu raporlar puanlamaya dahil edilmeyecektir.

1. Yarışmaya katılım başvuruları Savunma Sanayii Yapay Zekâ Platformu üzerinden yapılacaktır. Adaylar, konu özelindeki yeteneklerini ispatlayıcı nitelikte dokümanları (Akademik yayın, makale, patent, tamamlanmış projelerin özetleri vb.) yükleyerek ve y3portal.ssyz.org.tr adresinde yer alan Gizlilik Taahhütnamesini başvuru esnasında onaylayarak yarışmaya başvuracaklardır. Yarışmacı, Gizlilik Taahhütnamesini onaylamadığı takdirde başvurusu tamamlanmayacaktır.
2. Yarışmaya katılım için başvurular firma/kurum/kuruluş adına, bireysel ya da grup olarak yapılabilecektir.
3. Yarışmaya katılımı SSB tarafından onaylanan firma/kurum/kuruluş ve araştırmacıların/grupların başvuruda belirttikleri e-posta adresine yarışmaya kabul edildiklerine dair bildirim yapılacaktır.
4. Yarışmacılar katılım başvuruları haricindeki tüm işlemlerini (yazılımların yüklenmesi, yarışma ile ilgili bilgi paylaşımı ve sonuçların takip edilmesi vb.) SSB tarafından kendilerine bildirilecek olan kullanıcı adı ile, y3portal.ssyz.org.tr alanında tanımlı kullanıcı hesapları ile yapacaklardır.
5. Yarışmanın performans ölçüm süreçlerinin teknik yürütücüsü olan İTÜ Yapay Zekâ ve Veri Bilimi UYGAR Merkezi (İTÜ YZM) araştırıcıları ve öğretim üyeleri ile performans ölçme sürecine destek veren kişi, kurum ve firmalar bu yarışmaya katılamazlar.

1. Yarışmacılar üçüncü taraflara yarışma ile ilgili bilgilendirme veya basın açıklaması gibi herhangi bir bilgi paylaşımında bulunmayacaklardır
2. Yarışmacılar, yarışma kapsamında kendilerine verilen görüntü, veri ve bilgileri, üçüncü taraflar ile paylaşmayacaktır. Yarışmacı adayları başvuru esnasında Gizlilik Taahhütnamesini onaylayacaktır.
3. SSB’nin Yarışmacı olarak onayladığı kişi, firma ve kurumların gizliliğinin sağlanması için Yarışmacılar, başvuru aşamasının ardından tüm süreci kendilerine sağlanacak kullanıcı adları üzerinden devam ettireceklerdir.
4. Yarışmacıların kimlikleri ve hangi Yarışmacı hesabının hangi kişi/firma/kuruma ait olduğu sadece SSB tarafından bilinecek; İTÜ YZM, diğer Yarışmacılar ve üçüncü taraflar ile paylaşılmayacaktır.
5. Yarışmacılar kimliklerini İTÜ YZM ve üçüncü şahıslar ile paylaşmayacaktır.
6. Performans ölçümünde kullanılacak test verileri, süreç boyunca gizli tutulacak, hiçbir firma/kurum/kuruluş ve araştırmacı ile paylaşılmayacaktır.
7. İTÜ YZM yarışmacılar tarafından sağlanan yazılımları sadece performans ölçümü ve sonuçları SSB’ye raporlamak için kullanacaktır.
8. Gizlilik esaslarına ya da Gizlilik Taahhütnamesine uymayan Yarışmacılar yarışmadan diskalifiye edilecektir.

1. Yarışma sonuçları, SSB ve İTÜ YZM’ye herhangi bir hukuki ve mali yükümlülük getirmez. SSB, bu yarışma sonuçları dayanak gösterilerek herhangi bir sözleşme yapmaya zorlanamaz.
2. SSB ve İTÜ YZM, işbu yarışmaya esas teşkil edecek yazılımların hazırlanması, derlenmesi, yüklenmesi, testi ve benzeri faaliyetlere ilişkin olarak yarışmacıların yapacakları masraflardan ve karşılaşabilecekleri zarar ve harcamalardan hiçbir şekilde sorumlu tutulamaz.
3. SSB tarafından sağlanacak hesapların giriş şifrelerini değiştirmek ve bilgilerinin güvenliğini, gizliliğini korumak Yarışmacıların sorumluluğundadır.
4. Yazılımları performans ölçümünün gerçekleştirileceği sisteme yüklemek Yarışmacıların sorumluluğundadır.
5. Yazılımların yarışma için gerekli formata getirilerek, sisteme tekrar yüklenmesi gerekir ise, düzenlemeler yapılarak tekrar yüklenmesi Yarışmacıların sorumluluğundadır.
6. Yazılımların güvenli şekilde sisteme yüklenmesini sağlamak ve uygulamalarının koşturulması için seçilecek konfigürasyonun güvenlik koşullarını belirlemek yarışmacıların sorumluluğundadır.
7. SSB, kendi takdirine bağlı olarak, Yarışmaya Usul ve Esaslarında gerekli gördüğü değişiklikleri yapmakta, başvuru tarihlerini ve ödülleri değiştirmekte serbesttir.
8. Yarışmacılar yukarıda belirtilen Yarışma Usul ve Esaslarını peşinen kabul etmiş sayılır.