Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
542 commits
Select commit Hold shift + click to select a range
b42011a
Template for Ngso station generation
brunohcfaria Dec 17, 2024
ed1cafa
Fixed a wrong parameter passed to keplerian2eci in OrbitModel
brunohcfaria Dec 17, 2024
583038d
Merge branch 'imt_ntn_to_tn_dl_study_rebase' into ngso_orbit_prediction
brunohcfaria Jan 6, 2025
6a16f27
feat: beamforming imt antenna subarray
artistrea Dec 12, 2024
b0ee646
hotfix: how beamforming imt antenna fits in
artistrea Dec 18, 2024
d8e520f
fix: conducted power per subarray
artistrea Dec 19, 2024
9267c4f
fix: imt subarray broken tests and linting
artistrea Jan 6, 2025
981e7a0
Increased the time range for random satellite position in OrbitModel
brunohcfaria Jan 7, 2025
ea28333
Implementation of satellike look angle calculation function.
brunohcfaria Jan 7, 2025
8f5834d
Implementation of the SingleBs topology over spherical surface
brunohcfaria Jan 7, 2025
c3bfadd
bug fixed
araujoUnb Jan 8, 2025
343ba08
Satellite folder moved into sharc folder
araujoUnb Jan 8, 2025
4dcc261
bug fixed - Problems with identation
araujoUnb Jan 8, 2025
f630c56
moved to sharc/satellite folder
araujoUnb Jan 8, 2025
a7fcbb9
new stationType - StationType.NGSO
araujoUnb Jan 8, 2025
7bc348b
StationFactory update - Implementation of generate_ngso_constellation()
araujoUnb Jan 8, 2025
f38a9cb
Implementation of the MSS-D2D System
brunohcfaria Jan 8, 2025
e1bb032
Fixed a bug in CELL ue distribution type
brunohcfaria Jan 8, 2025
6d31665
Removed the squeeze constrint in imt path loss to cope with single IM…
brunohcfaria Jan 8, 2025
cfcb6e3
Reverting 7eebaa
brunohcfaria Jan 8, 2025
9bc84f2
Merge branch 'ngso_orbit_prediction' into feat_mss_d2d_to_imt
brunohcfaria Jan 9, 2025
d4cc3eb
Added satellite orbit path plot script
brunohcfaria Jan 10, 2025
c6e6df6
update of ParametersNgsoConstellation
araujoUnb Jan 15, 2025
f74eaac
Adding MSS-D2D parameters file
brunohcfaria Jan 15, 2025
df6f94b
bug fixed
araujoUnb Jan 15, 2025
4f5669f
Merge branch 'feat_mss_d2d_to_imt' of https://github.com/Radio-Spectr…
araujoUnb Jan 15, 2025
8e7c38f
removing parameter_ngso_constellation
araujoUnb Jan 16, 2025
3168eca
WIP: Initial version of the MSS-D2D to IMT campaign
brunohcfaria Jan 22, 2025
bf53d91
corrections on station_factory for mss_d2d
araujoUnb Jan 23, 2025
8ca523f
moving station_factory_test to to folder tests
araujoUnb Jan 23, 2025
4db3697
Merge branch 'feat_mss_d2d_to_imt' of https://github.com/Radio-Spectr…
araujoUnb Jan 23, 2025
7283125
removing old generate_mss_d2d
araujoUnb Jan 23, 2025
9ffee09
update test station_factory from ngso
araujoUnb Jan 23, 2025
d9b86f4
mss_d2d_multiple_orbits has an parameter called idx_orbit. I saves th…
araujoUnb Jan 25, 2025
9817cda
plot with multiple orbits.
araujoUnb Jan 25, 2025
70179d0
Added support for list type fields in ParametersBase
brunohcfaria Jan 27, 2025
b956f69
Added NGSO station factory unittest
brunohcfaria Jan 28, 2025
a68fd29
Added z-coorditate to the simulator geometry
brunohcfaria Jan 30, 2025
d57a2a7
Fixed missing z coordinate calculation in generate_mss_d2d
brunohcfaria Feb 3, 2025
2ef76c9
Added new support module for basic spherical geometry
brunohcfaria Feb 4, 2025
42a793a
WIP: Update base parameters for mss_d2d_to_imt campaign
brunohcfaria Feb 4, 2025
db6a931
Added visiable satellites and elevation angles histograms to
brunohcfaria Feb 4, 2025
f54b522
path loss between system and imt otimization where only active statio…
brunohcfaria Feb 7, 2025
143833e
Adding the implementation of station_factory to generate the UE's top…
Feb 7, 2025
eafd22e
fix: get off axis angle & d2d ngso geometrical attributes
artistrea Feb 10, 2025
d58301b
Added missing z-coordinate in the systems factory methods
brunohcfaria Feb 10, 2025
748f5a2
Modification on latitude and longitude calculation in OrbitModel
araujoUnb Feb 13, 2025
4f3591d
Merge branches 'feat_mss_d2d_to_imt' and 'feat_mss_d2d_to_imt' of htt…
araujoUnb Feb 13, 2025
6c94c80
hotfix: s1528 taylor gain at center of beam
artistrea Feb 17, 2025
2790d5a
feat: multiple transceiver antenna
artistrea Feb 17, 2025
bf3b53c
refactor: ntn topology calculate sectors
artistrea Feb 17, 2025
e46544b
feat: mss d2d station factory multiple transceivers and rotation base…
artistrea Feb 17, 2025
6b7a340
Revert "Modification on latitude and longitude calculation in OrbitMo…
artistrea Feb 28, 2025
cc3f38d
feat: transform geometry from 3d to 2d with imt at (0,0,0)
artistrea Feb 28, 2025
2bd0d84
update: how to set geometry reference
artistrea Feb 28, 2025
8bf34b4
Revert "Modification on latitude and longitude calculation in OrbitMo…
brunohcfaria Feb 28, 2025
160b057
Revert "update: how to set geometry reference"
artistrea Feb 28, 2025
16d9124
update: ngso tests
artistrea Mar 7, 2025
bdf8699
Added unittest configuration to vscode
brunohcfaria Mar 7, 2025
e826813
Added OrbitModel unit test
brunohcfaria Mar 7, 2025
4e092fa
Added a script to plot the histogram of visible satellites for OrbitM…
brunohcfaria Mar 7, 2025
4c42e6d
update: sharc geom converter
artistrea Mar 10, 2025
8b1b0c2
feat: reverse coordinate transformation
artistrea Mar 10, 2025
e768e5b
feat: satellite plot 3d footprint
artistrea Mar 10, 2025
2cf37b4
Added unittest configuration to vscode
brunohcfaria Mar 7, 2025
8d04a77
Added suport for effective radiating sizes parameters for S.1528 1.4 …
brunohcfaria Mar 12, 2025
9327466
Added Antenna parameters from 4C WD to MSS-D2D to IMT simulation camp…
brunohcfaria Mar 12, 2025
1571511
Merge branch 'feat_pathloss_between_active_stations' into feat/coordi…
brunohcfaria Mar 12, 2025
3948ee0
Changed the BS load prob to 100% in MSS-D2D to IMT simulation.
brunohcfaria Mar 13, 2025
74ff5e3
Changed the MSS-D2D station height to be relative to the Earth
brunohcfaria Mar 13, 2025
30a94dc
Fixed the antenna assignment in MSD-D2D factory
brunohcfaria Mar 13, 2025
2a831f5
Merge branch 'feat_mss_d2d_to_imt' into feat/coordinates_transformation
brunohcfaria Mar 13, 2025
b5f6503
Merge pull request #119 from Radio-Spectrum/feat/coordinates_transfor…
brunohcfaria Mar 13, 2025
d9f53ca
Fixing Station height setting in GeometryConverter
brunohcfaria Mar 13, 2025
61900ca
Fixed SatelliteSimple apparent elevation angle dimension
brunohcfaria Mar 13, 2025
957d5e4
update: downlink imt as victim adjacent band interference calculation
artistrea Mar 17, 2025
55d6aae
feat: mss spectral mask implementation
artistrea Mar 17, 2025
86ef3f2
update: calculate bw overlap to UEs
artistrea Mar 17, 2025
b1745a4
hotfix: disable adjacent channel
artistrea Mar 17, 2025
437f6ff
hotfix: downlink using only adjacent
artistrea Mar 17, 2025
ac6d792
update: better code dealing with IMT Downlink Victim adjacent interf
artistrea Mar 18, 2025
24d92a6
Merge pull request #115 from Radio-Spectrum/feat/imt_subarray_antenna
brunohcfaria Mar 19, 2025
0030a71
Merge pull request #111 from Radio-Spectrum/update/results
brunohcfaria Mar 19, 2025
4644903
Merge pull request #123 from Radio-Spectrum/feat/mss_partial_overlap_…
brunohcfaria Mar 19, 2025
3f51c4e
Changed Antenna parameters in plot_footprints.py to WP4C agreed param…
brunohcfaria Mar 14, 2025
b9135f8
Some parameters updade in MSS-D2D campaigns
brunohcfaria Mar 17, 2025
a76da87
Implementation of the TopologyImtMssDc
brunohcfaria Mar 19, 2025
16963f5
Added all satellite beams as base stations in TopologyImtMssDc
brunohcfaria Mar 20, 2025
9f37927
Added the space station generation for IMT MSS_DC topology
brunohcfaria Mar 20, 2025
947614c
adding missing paramters for TopologyImtMssDc
brunohcfaria Mar 20, 2025
d31a45f
feat: factor out ue manipulation to topology & transform imt ue onto …
artistrea Mar 20, 2025
f4dded8
update: station_factory plot script to something useful
artistrea Mar 20, 2025
011980e
hotfix: test parameters & imt parameter to turn off adjacent ch recep…
artistrea Mar 21, 2025
0020d80
update: added beamsteering limit to IMT
artistrea Mar 21, 2025
63117e5
update: added beamsteering limit to IMT
artistrea Mar 21, 2025
7a0bd30
hotfix: linting error
artistrea Mar 21, 2025
9a36dfa
hotfix: indoor test
artistrea Mar 21, 2025
3b90d36
update: change beamsteering default range to full range of motion
artistrea Mar 21, 2025
63299e6
hotfix: linting error
artistrea Mar 21, 2025
6efb31f
hotfix: indoor test
artistrea Mar 21, 2025
85c95f6
update: change beamsteering default range to full range of motion
artistrea Mar 21, 2025
b6b04e1
update: system_A parameters to include beamsteering range
artistrea Mar 21, 2025
7312c56
update: parameters for beamsteering range validation
artistrea Mar 24, 2025
4ffc2f2
update: parameters for beamsteering range validation
artistrea Mar 24, 2025
5445e69
hotfix: tests & calculate weights for many IMT BS's
artistrea Mar 24, 2025
e070cb1
hotfix: test parameters & imt parameter to turn off adjacent ch recep…
artistrea Mar 21, 2025
638ec84
hotfix: tests & calculate weights for many IMT BS's
artistrea Mar 24, 2025
52dd6ec
wip: making mss dc as imt topology work
artistrea Mar 25, 2025
8bcbcfd
Merge pull request #125 from Radio-Spectrum/feat/beamsteering_limit
brunohcfaria Mar 25, 2025
d20a68a
Merge pull request #126 from Radio-Spectrum/feat/mss_imt_beamsteering…
brunohcfaria Mar 25, 2025
e03bdd7
Change in Clutter Loss function and Addition possible P452 as propaga…
achilesfontanamota Mar 25, 2025
e39c4f9
fix: on UE interf calculation consider correct units
artistrea Mar 26, 2025
45ff70e
Changed Antenna parameters in plot_footprints.py to WP4C agreed param…
brunohcfaria Mar 14, 2025
8ba447f
Some parameters updade in MSS-D2D campaigns
brunohcfaria Mar 17, 2025
ae6fbe8
Fixed orbit parameters and graph labels in orbit_model_analysis.py
brunohcfaria Mar 25, 2025
a7c7d66
Merge branch 'feat/topology_imt_mss_dc' into feat_mss_d2d_to_imt
brunohcfaria Mar 26, 2025
b95bc3e
feat: antenna factory
artistrea Mar 26, 2025
27d1416
feat: setup for generic antenna array
artistrea Mar 28, 2025
e2e782e
fix: parameters base list loading & non existent params validation
artistrea Mar 28, 2025
ff7c098
fix: some unit tests
artistrea Mar 28, 2025
512dc95
update: simulation to work with new topology and antenna
artistrea Mar 28, 2025
96e7680
fix: simulations
artistrea Mar 28, 2025
89eca97
update: finished validation campaign
artistrea Mar 28, 2025
4fb0304
removed: validation campaign
artistrea Mar 28, 2025
178e2d2
feat: antenna factory
artistrea Apr 1, 2025
0cf97d3
feat: single space station
artistrea Apr 1, 2025
ac69d1a
feat: unit test for generating single space station
artistrea Apr 1, 2025
af326bb
fix: linting and test errors
artistrea Apr 1, 2025
49d6add
Changed cell radius for SystemA based on 7dB drop at the beam edge
brunohcfaria Apr 1, 2025
cdaa812
update: added antenna Reg RR Ap. 7 An. 3 to AntennaFactory
artistrea Apr 2, 2025
8e8c9a8
feat: space station input parameters documentation & some validation …
artistrea Apr 2, 2025
f265fa7
update: (maybe revert) commented all systems other than single es and…
artistrea Apr 2, 2025
84497a0
Added MSS-DC to IMT scenario with varying UE latitudes.
brunohcfaria Apr 2, 2025
9d248b4
feat: ue distribution_distance: SQRT(UNIFORM)
artistrea Apr 2, 2025
283c667
update: post processor with ccdf & legend generator
artistrea Apr 3, 2025
dadbb5d
hotfix: parameters test
artistrea Apr 4, 2025
d2364a6
feat: system mss d2d and topology mss dc with polygon intersection to…
artistrea Apr 4, 2025
7da09c2
chore: removed some comments
artistrea Apr 4, 2025
a0319cb
update: system_A campaign fixed and paraguay cross border study started
artistrea Apr 4, 2025
b77c76c
fix: polygon delimitation for active satellites bad performance, wron…
artistrea Apr 7, 2025
e2e1b35
Added Bessel Antenna unittest for model parameters.
brunohcfaria Apr 8, 2025
15d91c0
Merge pull request #132 from Radio-Spectrum/feat/single_space_station
brunohcfaria Apr 8, 2025
a050807
Merge pull request #133 from Radio-Spectrum/feat/ue_sqrt_distance_distr
brunohcfaria Apr 8, 2025
a6c4908
Merge pull request #134 from Radio-Spectrum/update/better_post_processor
brunohcfaria Apr 8, 2025
8d62463
feat: mss d2d beams load percentage & fix: imt mss dc topology & fix:…
artistrea Apr 14, 2025
904857f
Fixed SystemA parameters in the MSS-DC campaigns and related scripts
brunohcfaria Apr 14, 2025
d8815c8
Merge branch 'feat_mss_d2d_to_imt' into feat/mss_d2d_imt_ul
brunohcfaria Apr 15, 2025
d3cfd67
Merge branch 'feat_mss_d2d_to_imt' into feat/mss_d2d_to_imt_lat_varia…
brunohcfaria Apr 15, 2025
66ca80b
Fixed SystemA parameters in mss-dc latitude variation scenario
brunohcfaria Apr 15, 2025
044743f
Changed the default value for roll_off factor in S.1528 Antenna pattern
brunohcfaria Apr 15, 2025
bc1f372
Merge branch 'feat_mss_d2d_to_imt' into feat/mss_d2d_to_imt_lat_varia…
brunohcfaria Apr 15, 2025
170402b
Fixed mss_d2d_to_imt_co_channel_system_A parameters
brunohcfaria Apr 15, 2025
c17ac28
feat: mss d2d system random beam pointing
artistrea Apr 17, 2025
3186f7f
update: better footprint plot
artistrea Apr 17, 2025
030a0aa
Adding to all visible satellites footprint
Apr 22, 2025
c55922c
Merge branch 'feat_mss_d2d_to_imt' into feat/mss_d2d_polygon_limit
artistrea Apr 22, 2025
ad0af47
Added an installer for SHARC
Apr 22, 2025
c1bbf24
refactor: reused code for mss station as system and as imt
artistrea Apr 22, 2025
10268f5
update: post processor with ccdf & legend generator
artistrea Apr 3, 2025
0ad01f4
feat: random beam pointing for imt as well & fix: mss tests
artistrea Apr 22, 2025
7c9387f
Merge branch 'feat_mss_d2d_to_imt' into update/mss_system_and_imt
artistrea Apr 22, 2025
6999b4c
chore(script): changed plot footprint to plot footprint in Brazil area
artistrea Apr 22, 2025
a678efb
removed: incomplete parameter file
artistrea Apr 22, 2025
ba39421
removed: incomplete parameter file
artistrea Apr 22, 2025
9475a8e
update: mss topology may generate inactive satellites as well
artistrea Apr 22, 2025
a5b4785
Refactoring of the MSS-DC to IMT with varying latitude scripts.
brunohcfaria Apr 22, 2025
f27c8b7
Merge branch 'feat/mss_d2d_to_imt_lat_variation' into feat/mss_d2d_im…
brunohcfaria Apr 23, 2025
fe71f0c
Merge branch 'feat_mss_d2d_to_imt' into feat/mss_d2d_imt_ul
brunohcfaria Apr 23, 2025
b6c364d
Fixed list creation for imt_system_path_loss result in simulation dow…
brunohcfaria Apr 23, 2025
032d9ce
Added MSS-D2D to IMT-UL scenario
brunohcfaria Apr 23, 2025
09c99a5
Reorganized the MSS-D2D campaign scripts
brunohcfaria Apr 23, 2025
895d334
Merge pull request #138 from Radio-Spectrum/feat/mss_d2d_polygon_limit
brunohcfaria Apr 23, 2025
3ad4e42
Merge remote-tracking branch 'origin/feat_mss_d2d_to_imt' into feat/m…
brunohcfaria Apr 23, 2025
7696434
Merge remote-tracking branch 'origin/feat_mss_d2d_to_imt' into update…
brunohcfaria Apr 23, 2025
0210bbe
Merge pull request #143 from Radio-Spectrum/update/mss_system_and_imt
brunohcfaria Apr 23, 2025
d80dbc5
Flake8 errors
TenTemujin Apr 24, 2025
2d005c2
fix: tests
artistrea Apr 24, 2025
016b008
Merge pull request #147 from Radio-Spectrum/feat/installer
brunohcfaria Apr 24, 2025
aba91fe
Merge pull request #146 from Radio-Spectrum/feat/mss_d2d_imt_ul
brunohcfaria Apr 24, 2025
329b31b
fix(script): imt mss dc plot sectors
artistrea Apr 24, 2025
e795567
Updated the random Orbit model logic.
brunohcfaria Apr 28, 2025
163a9dd
Fixed Nsp for SystemA parameters
brunohcfaria Apr 28, 2025
f0a6dd4
Vectorized the random orbit model method
brunohcfaria Apr 28, 2025
dd2c426
Changed auto_open option to False in orbit_model_analysis script
brunohcfaria Apr 28, 2025
61dfd0f
Added OrbitModel.get_orbit_positions_random docstring
brunohcfaria Apr 28, 2025
10fd264
Updates to the plot_satellites 3D script
brunohcfaria Apr 28, 2025
1dc9277
Added Python compatible version verification
Apr 29, 2025
81aa3ab
Merge pull request #150 from Radio-Spectrum/exp/random_orbit
brunohcfaria Apr 29, 2025
6a18ff0
Merge pull request #151 from Radio-Spectrum/feat/installer
brunohcfaria Apr 29, 2025
9c7e84e
Refactoring of the IMT-NTN to IMT-DL campaign
brunohcfaria Apr 29, 2025
e49a881
Updates to the IMT-NTN to IMT parameter template
brunohcfaria Apr 29, 2025
469725f
Set UE ohmic loss to zero in MSS-D2D to IMT campaign
brunohcfaria May 7, 2025
4e14235
Merge pull request #153 from Radio-Spectrum/update/mss_ss_to_imt
brunohcfaria May 7, 2025
89cf530
Remove ini deprecated files
May 8, 2025
f65861a
feat: Daniel's pfd implementation for ue as victim
artistrea Apr 30, 2025
ec54b34
update: mss dc/d2d filter active satellite by max elevation
artistrea Apr 30, 2025
2b7c84e
update: mss polygon filter can filter sats inside many countries
artistrea May 12, 2025
deb40bd
hotfix: parameters mss d2d validation
artistrea May 12, 2025
a91b7c1
update: script plot footprint to new mss d2d params
artistrea May 12, 2025
0a9d36e
feat: script plot 3d mss param file
artistrea May 12, 2025
3faa8a6
Merge pull request #155 from Radio-Spectrum/unused_ini
brunohcfaria May 13, 2025
d34487b
Merge pull request #154 from Radio-Spectrum/feat_dl_pfd_and_mss_angle…
brunohcfaria May 13, 2025
441d5e6
Merge pull request #156 from Radio-Spectrum/update/mss_polygon_filter
brunohcfaria May 13, 2025
1852097
feat(campaign): added cross border mss campaign
artistrea Apr 30, 2025
dfb595c
fix: campaign mss d2d crossborder to new parameters implementation
artistrea May 12, 2025
beb7de2
update: post processor to enable diff linestyle per results
artistrea May 12, 2025
a4ca63a
fix: campaign mss d2d cross border params
artistrea May 13, 2025
14013a0
Merge pull request #158 from Radio-Spectrum/feat/mss_cross_border_cam…
brunohcfaria May 13, 2025
6c0c890
Removed unessessary parameters for AntennaS1528Taylor
brunohcfaria May 14, 2025
a7484d8
Fixes the calcultation of Bessel roots in AntennaS1528Taylor
brunohcfaria May 14, 2025
8a37e7b
Minor fix that creates the htmls output directory if it doesn't exist
brunohcfaria May 13, 2025
7948c5d
update: cross border generate inputs script
artistrea May 16, 2025
b509dde
Minor sintax fix in mss-d2d to imt cross-border plot results
brunohcfaria May 16, 2025
b71bb96
Merge remote-tracking branch 'origin/development' into feat_mss_d2d_t…
brunohcfaria May 19, 2025
0444b6c
Fixed lint errors
brunohcfaria May 19, 2025
9c9c7b3
Fixed lint errors in the tests folder.
brunohcfaria May 19, 2025
d3e101e
Updated requirements.txt
brunohcfaria May 19, 2025
e0e0449
Fixed flaky test for test_orbit_model
brunohcfaria May 19, 2025
2f31fbf
Removed wrong reference to sharc repo in requirements.txt
brunohcfaria May 19, 2025
7555bea
Updated country_names param in topology_imt_nmss_dc script
brunohcfaria May 20, 2025
4c677d8
Fixed the S.1528 reference antenna plot
brunohcfaria May 20, 2025
526e992
Removed outdated ini files
brunohcfaria May 20, 2025
e4da4c9
Removed outdated ngso parameter file
brunohcfaria May 20, 2025
3c61ccb
Removed duplicate parameter in parameters.yaml
brunohcfaria May 20, 2025
3faad0c
Removed unecessary parameters file in the satellite module
brunohcfaria May 20, 2025
b63da61
Update sharc/simulation.py
brunohcfaria May 20, 2025
932d8b6
Update sharc/sharc_definitions.py
brunohcfaria May 20, 2025
fbf1c87
Update .gitignore file
brunohcfaria May 20, 2025
f6af3f2
Removed outdated parameters for systems that falls into
brunohcfaria May 20, 2025
37c59d5
Update sharc/parameters/imt/parameters_imt_topology.py
brunohcfaria May 20, 2025
5f1066d
Update sharc/parameters/imt/parameters_single_bs.py
brunohcfaria May 20, 2025
a1c15bd
Update sharc/parameters/parameters_p619.py
brunohcfaria May 20, 2025
c78f7cb
Removed unused script sharc/satellite/simulation_loop.py
brunohcfaria May 20, 2025
0536555
Removed ne_110m_admin_0_countries.README.html file
brunohcfaria May 20, 2025
b8d8b6e
Moved the country shape file to a single place.
brunohcfaria May 20, 2025
d4f914f
Moved plot_3d_param_file to the cross-border campaign folder
brunohcfaria May 20, 2025
f3140d3
Removed outdated script plot_orbits_multiple_colors_3d.py
brunohcfaria May 20, 2025
5c48490
update(script): plot_footprints.py cleaner and colorscale fixed
artistrea May 21, 2025
9b5d825
update: utility run mult campaigns better validation
artistrea May 21, 2025
252ab90
fix(campaign): mss d2d cross border plot_results.py missing prefix
artistrea May 21, 2025
176125c
update(campaign): mss d2d cross border better script plot_3d_param_fi…
artistrea May 21, 2025
55621ab
Added tolerance to the calculate elevation angle test.
brunohcfaria May 22, 2025
d85ea6d
Merge pull request #159 from Radio-Spectrum/feat_mss_d2d_to_imt
brunohcfaria May 22, 2025
94a9dcb
update(postprocessor): Added minor ticks to logy plots for CCDF as de…
brunohcfaria May 26, 2025
20b30f9
update(postprocessor): Added missing docstrings
brunohcfaria May 26, 2025
acbf0be
update(campaign): Updates to the MSS-D2D to IMT campaign plot scripts
brunohcfaria May 26, 2025
d362d08
update(campaign): Added .gitignore to the input folder o MSS-DC to IM…
brunohcfaria May 26, 2025
4dc7b3d
fix(postprocessor): Fixed missing step range for major ticks in post …
brunohcfaria May 27, 2025
d285cdd
Merge pull request #164 from Radio-Spectrum/update/mss_d2d_to_imt_cam…
brunohcfaria May 27, 2025
4ae7011
Added parameters to p619 and p452, while updeted 3.3 of 2108
Jul 28, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 45 additions & 0 deletions .github/workflows/unittest-lint.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
name: Python application

on:
push:
branches:
- master
- development
- 'v1.*'
pull_request:
branches:
- master
- development
- 'v1.*'
types:
- opened
- reopened
- synchronize

permissions:
contents: read

jobs:
build:
runs-on: ubuntu-latest

steps:
- uses: actions/checkout@v4
- name: Set up Python 3.12
uses: actions/setup-python@v3
with:
python-version: "3.12"
- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install flake8
if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
- name: Lint with flake8
run: |
# stop the build if there are Python syntax errors or undefined names
flake8 . --count --select=E9,F63,F7,F82,W191,W291,W292,W293,W391,E131,E2,E3,E266 --ignore=E266 --show-source --statistics
# exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
- name: Test with unittest
run: |
python -m unittest discover -s tests
33 changes: 32 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,7 +1,9 @@
/sharc/logfile.log
/sharc/output/*.txt
/sharc/output/*.csv
/sharc/output/*.png
/sharc/output_*/*
/sharc/campaigns/*/output/


__pycache__
.spyproject
Expand All @@ -17,6 +19,7 @@ __pycache__/

# Distribution / packaging
.Python
venv/
env/
build/
develop-eggs/
Expand Down Expand Up @@ -70,3 +73,31 @@ target/
# pyenv python configuration file
.python-version
/sharc/antenna/figs
/sharc/.venv/
.DS_Store
.venv/
venv/
myenv/pyvenv.cfg
myenv/Scripts/activate
myenv/Scripts/activate.bat
myenv/Scripts/Activate.ps1
myenv/Scripts/deactivate.bat
myenv/Scripts/pip.exe
myenv/Scripts/pip3.12.exe
myenv/Scripts/pip3.exe
myenv/Scripts/python.exe
myenv/Scripts/pythonw.exe

# Ignore output files
[IMT]*.txt
[SYS]*.txt
IMT_*.txt
SYS_*.txt


# Ignores campaigns output

/sharc/campaigns/imt_*/output/output_imt*/*.csv
/sharc/campaigns/imt_*/output/output_imt*/*.yaml
/sharc/campaigns/imt_*/output/Figs/*.png
sharc/campaigns/mss_d2d_to_imt/output/*.yaml
16 changes: 16 additions & 0 deletions .vscode/extensions.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
{
// See https://go.microsoft.com/fwlink/?LinkId=827846 to learn about workspace recommendations.
// Extension identifier format: ${publisher}.${name}. Example: vscode.csharp

// List of extensions which should be recommended for users of this workspace.
"recommendations": [
"ms-python.python",
"ms-python.debugpy",
"ms-python.flake8",
"ms-python.autopep8"
],
// List of extensions recommended by VS Code that should not be recommended for users of this workspace.
"unwantedRecommendations": [

]
}
16 changes: 16 additions & 0 deletions .vscode/launch.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
{
"version": "0.2.0",
"configurations": [
{
"name": "Python Debugger: SHARC main_cli.py",
"type": "python",
"request": "launch",
"program": "${workspaceFolder}/sharc/main_cli.py",
"console": "integratedTerminal",
"args": [
"-p",
"${workspaceFolder}/sharc/input/parameters.yaml"
]
}
]
}
31 changes: 31 additions & 0 deletions .vscode/settings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
{
"[python]": {
"editor.defaultFormatter": "ms-python.autopep8",
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.organizeImports": "explicit"
},
"editor.rulers": [
120
]
},
"flake8.args": [
"--count",
"--max-line-length=127",
"--statistics",
"--ignore=W605,W504,E266,F811,E131,C0209,C0103,C0115,C0115,C0116,C0201"
],
"autopep8.args": [
"--max-line-length 120",
"--agressive"
],
"python.testing.unittestArgs": [
"-v",
"-s",
"./tests",
"-p",
"test_*.py"
],
"python.testing.pytestEnabled": false,
"python.testing.unittestEnabled": true
}
202 changes: 202 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,202 @@
# Contributing

Contributions are welcome, and they are greatly appreciated! Every
little bit helps, and credit will always be given.

You can contribute in many ways:

## Types of Contributions

### Report Bugs

Report bugs at https://github.com/Radio-Spectrum/SHARC/issues

If you are reporting a bug, please include:

* Your operating system name and version.
* Any details about your local setup that might be helpful in troubleshooting.
* Detailed steps to reproduce the bug.

### Fix Bugs
Look through the GitHub issues for bugs. Anything tagged with "bug"
and "help wanted" is open to whoever wants to implement it.

### Implement Features
Look through the GitHub issues for features. Anything tagged with "enhancement"
and "help wanted" is open to whoever wants to implement it.

### Write Documentation
SHARC could always use more documentation, whether as part of the
official SHARC docs, in docstrings, or even on the web in blog posts,
articles, and such.

When implementing a new feature such as a new propagation model or a new antenna model,
add the documentation to the Wiki.

### Submit Feedback
The best way to send feedback is to file an issue at https://github.com/Radio-Spectrum/SHARC/issues.

If you are proposing a feature:

* Explain in detail how it would work.
* Keep the scope as narrow as possible, to make it easier to implement.
* Remember that this is a volunteer-driven project, and that contributions
are welcome :)

## Branching model

The branching model is based on this excelent post written by Vincent Driessen.

A Successful Git Branching Model - https://nvie.com/posts/a-successful-git-branching-model/

### The main branches
The central repo holds two main branches with an infinite lifetime:

* `master` - main branch where the source code of HEAD always reflects a production-ready state.
* `development` - the main branch where the source code of HEAD always reflects a state with the latest
delivered development changes for the next release

When the source code in the `development` branch reaches a stable point and is ready to be released,
all of the changes should be merged back into `master` and then tagged with a release number.

### supporting branches
The supporting porting branches to aid parallel development between team members, ease tracking of features,
prepare for production releases and to assist in quickly fixing live production problems.
Unlike the main branches, these branches always have a limited life time, since they will be removed eventually.

* `feature` branches
* `release` branches
* `hotfix` branches

### feature branches
Feature branches are used to develop new features. For example, an addidion of a new antenna model or
a new propagation model.

May branch off from:
`develop`
Must merge back into:
`develop`
Branch naming convention:
anything except `master`, `development`, `release-*`, or `hotfix-*`. For example, `feature-propagation-619`.

### release branches
Release branches support preparation of a new production release. They allow for minor bug fixes and
preparing meta-data for a release (version number, build dates, etc.)

May branch off from:
`develop`
Must merge back into:
`develop` and `master``
Branch naming convention:
`release-*`

### hotfix branches
Used when a critical bug in a production version must be resolved immediately.

May branch off from:
`master`
Must merge back into:
`develop` and `master`
Branch naming convention:
`hotfix-*`

## Languages

### Python

The [PEP8 style guide](https://www.python.org/dev/peps/pep-0008/) is authoritative.

#### Type annotations
All new code should be fully type-annotated.
For reference, please look at this [type hints cheat sheet for Python 3](https://mypy.readthedocs.io/en/stable/cheat_sheet_py3.html).

#### Documentation
* Document all public functions and keep those docs up to date when you make changes
* We use [Google style docstrings](https://google.github.io/styleguide/pyguide.html#383-functions-and-methods) in our codebase (if you find a docstring missing or in the wrong format you're welcome to fix it.)
* For VSCode users, [Python Docstring Generator](https://marketplace.visualstudio.com/items?itemName=njpwerner.autodocstring) plugin is recommended
Example:

```
def foo(arg1: str) -> int:
"""Returns the length of arg1.

Args:
arg1 (str): string to calculate the length of

Returns: the length of the provided parameter
"""
return len(arg1)
```


## Get Started!
Ready to contribute? Here's how to set up `sharc` for local development.

1. Fork the `sharc` repo on GitHub.
2. Clone your fork locally:

`$ git clone git@github.com:your_name_here/sharc.git`

`$ cd SHARC/`

3. Install any version of python 3 and the virutalenv module in your system (SHARC has been tested from versions 3.8 and above).
4. Install your local copy into a virtualenv.

`$ cd sharc`

`$ python3 -m venv .venv`

`$ source .venv/bin/activate`

You shall see (.venv) in the begining of your command prompt indicating that the virutalenv has been activated.
Now, instalal the dependencies for development.
`$ pip install -r requirements.txt`

Install sharc on your local enviroment.
Run from the source code directory root:
`$ pip install -e .`

4. Create a branch for local development::

`$ git checkout -b name-of-your-bugfix-or-feature`

Now you can make your changes locally.

5. When you're done making changes, check that your changes pass flake8 and the tests, including testing other Python versions with tox:

`$ flake8 sharc tests`

`$ python setup.py test or py.test`


To get flake8 and tox, just pip install them into your virtualenv.

6. Commit your changes and push your branch to GitHub::

`$ git add .`

`$ git commit -m "Your detailed description of your changes."`

`$ git push origin name-of-your-bugfix-or-feature`

7. Submit a pull request through the GitHub website.

# Pull Request Guidelines

Before you submit a pull request, check that it meets these guidelines:

1. The pull request should include tests.
2. If the pull request adds functionality, the docs should be updated. Put
your new functionality into a function with a docstring, and add the
feature to the list in README.rst.
3. The pull request should work for Python 2.6, 2.7, 3.3, 3.4 and 3.5, and for PyPy. Check
https://travis-ci.org/edgar-souza/sharc/pull_requests
and make sure that the tests pass for all supported Python versions.

Tips
----

To run a subset of tests::

$ py.test tests.test_sharc

4 changes: 3 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,4 @@
# SHARC
Simulator for use in sharing and compatibility studies of radio communication systems
Welcome to SHARC, a simulator for use in SHARing and Compatibility studies of radiocommunication systems. The development of this software is being lead by the Telecommunications Regulatory Authority (TRA) of Brazil, ANATEL, and it implements the framework proposed by Recommendation ITU-R M.2101 for "modelling and simulation of IMT networks and systems for use in sharing and compatibility studies".

Please refer to `CONTRIBUTING.md` for contribution guidelines and how to setup your environment.
Loading