To request a download link for the FOS Simulator file, please send an email to indopacom.humphreys.usfk.mbx.usfk-coding-challenge@army.mil with following subject format:
[GET-INFO] __YOUR_SUBJECT__
The email box above will auto-reply to your email immediately. If you do not receive a reply email immediately, please check your email subject or request help to us.
If you encounter any issues or bugs with the simulator, please contact SGT Mun, Chaeun, USFK J5 AI/ML Planning Assistant, Digital O-Plan, via email at chaeun.mun.fm@army.mil for request assistance.
Detailed Description
For more comprehensive information on how to use the simulator and for additional details, please reference the README.md document at release repository.
There are two methods for operating the FOS simulator: running on a desktop and using a browser.
Running on your Desktop
Disclaimer/Warning
Please note that downloading FOS binaries on DoDIN devices, such as NIPRNET Computers, is strictly prohibited. According to the Army IT User Agreement (AUP), downloading or running any executable files on government devices without proper authorization from the AO is not allowed.
To run the FOS simulator on your desktop
- Download the appropriate Binary/Executable FOS Simulator file for your operating system from the listed release repository (Please see the 'Download Binary' section above).
- Execute the downloaded executable file with command line arguments. If the arguments are not specified, the program will attempt to receive required entries that have not been entered into the CLI interface since it was executed.
Example
./"FOS Simulator" --host 127.0.0.1 --port 8080
for index, arg in enumerate(argv):
if arg == "help" or arg == "-help" or arg == "-h" or arg == "--help":
print("""Usage:
--help : to list all available
--host [IP Address, Str] : host to connect to
--port [Port, Int] : port to connect to
--visualize [0/1] : visualize or not
--logging [0/1] : enable log printing using stdout or not
""")
sys.exit(0)
match (arg.startswith("--"), arg):
case True, "--host":
result["host"] = argv[index + 1]
case True, "--port":
result["port"] = int(argv[index + 1])
case True, "--visualize":
result["visualize"] = bool(int(argv[index + 1]))
case True, "--logging":
result["logging"] = bool(int(argv[index + 1]))
The simulation log file will be automatically stored in the same directory as the simulator, named play_log.json.
Running on the Browser
To run the FOS simulator on your browser
- Download and save the FOS Simulator HTML and WASM related files in one directory from the listed release repository. Open index.html with your browser. If you use the file:// protocol when running index.html, you may need to adjust your browser's CORS settings to enable the loading of WASM files.
C:\"Program Files (x86)"\Microsoft\Edge\Application\msedge.exe --disable-web-security --user-data-dir="C:\Users\_YOUR_USER_NAME__\Desktop\FOSWEB"
or
- It might be helpful to search for 'How to disable Cross-Origin Resource Sharing (CORS)'.
Alternatively, implement a web server to access index.html using the http:// protocol instead of the file:// protocol. You can also visit or FOS Simulator sample web page by referencing the README.md document at release repository.
- Enter the address of the controller server to which the simulator will connect.
The simulator operates using WebAssembly on your local machine, rather than on a remote server. Even if you are targeting to run FOS simulator with your browser, you can connect to a locally hosted server(FOS Controller). The browser implementation primarily caters to individuals working on DoDIN computers. If you need to work within a browser, you can implement a local TCP server for the controller or use an external server to establish a connection.
- After completing the simulation, remember to download your play log file from your browser.
If I submit my code to the challenge, will I still have ownership over my code?
All applicants will maintain intellectual property of any work submitted during the initial phases of the challenge.
Can I submit my code in another format other than what is listed?
Unfortunately, not at this time but feel free to still submit your work for this challenge via the methods provided.
Will there be someone else looking at my code?
All submission will be reviewed by the judging panel but in addition to that, your code will also be reviewed by the Joint Cyber Center.
Can I use official work time to work on my submission?
That is up to each individual and his/her supervisor. The work being done for this challenge will have direct military impact on the joint planning requirement that occurs at the USFK HQ level. Primary work is the priority but we appreciate your interest and creative solutions as we look towards AI/ML solutions.
Who is running this challenge?
This coding challenge is being managed by the USFK J5 staff.
I have another question but don't see it here. Who can I call for more information?
Please contact Lt. Col. Nicklaus Walker, USFK J5 Chief of Digital Planning, via email at
nicklaus.m.walker.mil@army.mil or via phone at DSN (315) 755-4560 (COMM
050-3355-4560).