Skip to content

Demand generator for various USMC elements across the competition, crisis, and conflict continuum.

License

Notifications You must be signed in to change notification settings

itsalljokay/UnitDemandGenerator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UnitDemandGenerator

UnitDemandGenerator is a demand generation tool for daily demand requests for platoon, company, MLR, and MEF sized-elements in competition, crisis, or conflict states.

Getting Started

There are two options for running this project, in the browser or locally.

To Run In The Browser

Follow this link to the online notebook. Alternatively, click on UnitDemandGeneratorOnline.ipynb in this repository and then the "Open in Collab" button that appears at the top.

To run the code in Google Collab, navigate to the RunTime menu, and then run all. If prompted that this is not a native Google Collab file, select run anyway.

CollabRun

To view the outputs, select files from the side menu, then the outputs folder. In the outputs folder, all the spreadsheets will be organized by class, state, and unit. There will also be an all_data file that will contain all the data without the organizational categories listed.

Collab Files

To open a spreadsheet, double-click on the .csv to open. Pull the slider bar to view the spreadsheet to desired size.

Collab Open

To download a spreadsheet, click the hamburger menu icon (three dots) next to the file name and select download.

Download File

To Run Locally

This project requires Python with the following libraries.

  • Numpy
  • Pandas

Setup your environment to be able to run Python files, as well has have the necessary permissions to allow the import functions in main.py to download the above dependencies. Run as you would a normal Python file, and the outputs will populate in the appropriate folders.

Usage

Detailed commenting is provided within the main.py program file.

For more extensive references and walkthroughs please refer to the Wiki.

 The intended audience is a Marine, unfamiliar with programming or simulation.

Output

Sampling of a few output methods are included below. Please refer to the Wiki for list of all outputs.

CSV Of All Data

all_data

CSV Of Class One Data

class_one_data

CSV Of Conflict Data

conflict_data

CSV Of MLR Data

mlr_data

Contributing

Forks are welcome. This was one of my first projects in Python, and as such, being able to see better practices, improvements, and alternate methods is gladly received.

License

MIT

Author

Jessi Lanum

At the time of creation and first usage, this repository represents the best efforts of a 2nd Lieutenant to improve computational science practices within the Marine Corps. For more information about this, please visit below.

About

Demand generator for various USMC elements across the competition, crisis, and conflict continuum.

Topics

Resources

License

Security policy

Stars

Watchers

Forks